RESTful

Posted 2020-10-12 maxiaohei

每个url代表一种资源

客户端和服务器之间，传递这种资源的某种表现层

 

 

 

一 、域名：

http://www.example.com

将api添加到专用域名下

http://www.example.com/api

二、 版本

版本号 

http://www.example.com/api/1.0

三、 路径

url中不能出现动词，表现层状态转换，资源都要名称描述，名称要使用复数，最好和模型对应

http://www.example.com/api/1.0/goods

http://www.example.com/app/goods

四、 使用标准的HTTP方法

 

对资源的具体操作类型，常用四个动词

GET        SELECT: 从服务器获取资源

POST      CREATE:从服务器新建资源

PUT        UPDATE:

DELETE  DELETE:从服务器删除资源

示例：

获取指定商品信息

GET  http://www.example.com/app/goods/ID

新建指定商品信息

POST  http://www.example.com/app/goods/ID

五、 过滤信息

资源数据较多，不能讲所有数据一次性全部返回给客户端

POST  http://www.example.com/app/goods/?limit=10

六、 状态码（前后端分离的开发都要用到状态码）

 

201 CREATED ：用户新建或修改数据成功。
202 Accepted：表示请求已进入后台排队。
400 INVALID REQUEST ：用户发出的请求有错误。
401 Unauthorized ：用户没有权限。
403 Forbidden ：访问被禁止。
404 NOT FOUND ：请求针对的是不存在的记录。
406 Not Acceptable ：用户请求的的格式不正确。
500 INTERNAL SERVER ERROR ：服务器发生错误。


七、 自定义错误信息

八、 响应结果

九、 使用连接关联相关资源

十、 其他

前后端分离可以实现后端接口的复用，提高开发效率