http://codeplanet.io/principles-good-restful-api-design/
hateoas
http://en.wikipedia.org/wiki/HATEOAS
http://en.wikipedia.org/wiki/RSDL
http://www.doc88.com/p-1367381447735.html
if match
if none match
google restful api design
http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api#snake-vs-camel
https://stripe.com/docs/api#charge_object
https://developer.github.com/v3/gists/#list-gists
url: v + n(s) + (phase)
adj
queryString: ?state=adj&order=property&query=cond
queryString:(POST) 真正请求的参数
list/financePlan?status=investable&order=openDate&query=status:open
list/financePlan/repay?
list/financePlan/5/repay?是否能识别?
detail/loanInvestor/5?state=invested.....
invest/loan/125?state=...
add/user/before
add/user
add/user/after
v:
do
add
update
delete
list
detail
invest
status :
investable, investing, invested
redeemable, redeeming, redeemed
phase:
before,after
优秀api鉴赏