- 建议使用https代替http
- 建议要有api标识
https://www.baidu.com/api/ (建议)
https://api.baidu.com
- 建议加上版本
https://www.baidu.com/api/v1/
https://www.baidu.com/api/v2/
- 面向资源编程,认为网络上的任何东西都是资源,用名词来标识资源。
https://www.baidu.com/api/v1/order/
- 根据method不同做不同操作
- get 获取数据,从服务器取出资源(一项或多项)。
- post 创建,在服务器新建一个资源。
- delete 删除,从服务器删除资源。
- put 更新,在服务器更新资源(客户端提供改变后的完整资源)。
- 条件
https://www.baidu.com/api/v1/order/?page=11&date=2019
- 建议返回数据要加状态码(实战中基本上都是用code字段)
200 连接成功
301 重定向
302 临时重定
403 服务器拒绝请求
404 服务器找不到请求网页
500 服务器错误
- 建议出现错误,要返回错误信息
{"code":‘1000‘,‘error‘:‘认证失败‘}