REST (Representational State Transfer):表现层状态转移
Restful api接口特征:
1.URL的根路径
http://www.baidu.com/
2.需要有Api版本信息
http://www.baidu.com/v1
3.URL中只使用名词指定资源,不用动词,比如这里表示关于用户的操作
http://www.baidu.com /v1/user
4.用HTTP协议里的方法类型来实现资源的增删查改等操作
GET 获取资源
POST 创建资源
PUT 修改资源
DELETE 删除资源
GET应该是安全的,只是查询,不会进行增,删,改的操作。
返回的json数据固定为这样格式的:
{
"msg": ,
"code": ,
"data": ,
"bizcode":
}
Http响应码含义:
状态码 | 状态码含义 |
---|---|
200 | 请求成功,且服务器已创建了新的资源 |
201 | 是否只显示处于警告状态的应用实例 |
301 | 重定向, 请求的网页已被永久移动到新位置。同时服务器自动将该请求者转到新位置 |
302 | 重定向, 请求的网页临时移动到新位置。同时服务器自动转到不同的临时位置 |
304 | 未修改,自从上次请求后,请求的网页未被修改过。服务器返回此响应时,不会返回网页内容 |
400 | 错误请求, 服务器不理解请求的语法 |
401 | 未授权, 请求要求进行身份验证 |
403 | 已禁止, 服务器拒绝请求 |
404 | 未找到, 服务器找不到请求的网页 |
405 | 方法禁用, 禁用请求中所指定的方法 |
406 | 不接受, 无法使用请求的内容特性来响应请求的网页 |
408 | 请求超时, 服务器等候请求时超时 |
410 | 已删除, 如果请求的资源已被永久删除 |
412 | 未满足前提条件, 服务器未满足请求者在请求中设置的其中一个前提条件 |
415 | 不支持的媒体类型, 请求的格式不受请求页面的支持 |
500 | 内部服务器错误 |
总结规则:
1.Url要表现出操作的对象是什么
2.HttpMethod要表现出要进行哪种操作(CURD)
3.定义的code要表现出返回的成功与否