API

阅读以下链接：
https://hackernoon.com/restful-api-designing-guidelines-the-best-practices-60e1d954e7c9

https://www.snyxius.com/blog/21-best-practices-designing-launching-restful-api/#.WUJcEROGOHo

在线编辑：
http://editor.swagger.io/

if post/put, 输入参数应为 body/path;
if get, 输入参数应为 path/query;
if delete, 输入参数应为 path

path 有业务层级关系的查询参数；query 只是查询参数