一:resful规范
1.与后台交互,通常使用https
2.域名 https://api.baidu.com
http://baidu.com/api/
3.版本:http://baidu.com/api/v1
http://baidu.com/api/v2
4.网络上所有的东西都是资源,都用名字(可复数)
https://api.example/v1/books
https://api.example/v1/get_books(不是get_book动词)
5.get 获取资源 post 新增数据 delete 删除数据 put/patch 修改数据
6.过滤,通过在url上传参的形式传递搜索条件:
意思:只拿前10本书
https://api.example.com/v1/books?limit=10
7.状态码 {status:100}
8.错误处理,应返回错误信息,error当做key
{error: Invalid API key}
9.返回结果,针对不同操作,服务器向用户返回结果符合以下规范
10.返回结果可以返回一个链接,例如:
{ id:1 name:lxx price:12 publish:www.xx.com/api/v1/publish/1 }