RESTful_API快速复习

教程地址：https://www.bilibili.com/video/av35544323

GET /userlist 获取用户列表

POST /userlist 获取用户列表

GET /userlist/110 获取编号为110的用户信息

GET /userlist/110/states/1   获取当前用户的状态

1、应该尽量将API部署在专用域名之下 api.baidu.com

2、如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。 www.baidu.com/api/

3、应该将API的版本号放入URL  api.baidu.com/v1/ 或 api.baidu.com/va/  用10进制的v1到v10或者用26字母来当做26进制 va到vz

4、写测试用例 ceshi.baidu.com/v1/   该地址返回的数据是写死的用于测试

5、在RESTful架构中，每个网址代表一种资源 所以网址中不能有动词，只能有复数名词，名词往往与数据库的表格名对应

6、pi.baidu.com/v1/fruits   pi.baidu.com/v1/animals  输出所有水果信息   与  输出所有动物信息

7、对于资源的具体操作类型，动词表示，例如： list（取出多条信息）  info(取出单条信息)    upinfo(更新信息)    del(删除信息)   

8、服务器返回的数据格式，应该尽量使用JSON，避免使用XML。

参数	解释
limit=1	指定返回记录的数量
offset=10	定返回记录的开始位置
page=1  per_page=10	指定第几页，以及每页的记录数
sortby=create_time     order=asc	以create_time   的 asc排序显示