一、RESTful设计风格
基础概念
全称:Representational State Transfer
1.资源
网络上的一个实体,每个资源都有一个独一无二的URL与之对应;获取资源-直接访问URL即可
2.表现层
资源的表现形式 如HTML、xml、JPG、json等
3.状态转化
访问一个URL即发生一次客户端和服务端得交互;此次交互将会涉及到数据和状态得变化
客户端需要通过某些方式接触具体得变化 如GET、POST、PUT、PATCH、DELETE
设计原则
1.协议 - http/https
2.域名
域名中体现出api字样
https://api.example.com/v1 或 https://example.org/api/.
3.版本
https://api.example.com/v1
4.路径
路径中避免使用动词,资源用名词表示
5.HTTP动词语义
GET、POST、PUT、PATCH、DELETE
示例
6.巧用查询字符串
7.状态码
1)用HTTP响应码表达
2)自定义内部code进行响应
{’code‘:'00000','msg':'success','data':{}}