美文网首页
RESTfull接口规范

RESTfull接口规范

作者: One_仑 | 来源:发表于2019-03-11 19:56 被阅读0次
REST 是Representational State Transfer的缩写,翻译是”表现层状态转化”。 可以 总结为一句话:REST是所有Web应用都应该遵守的架构设计指导原则。

面向资源是REST明显的特征,对于同一个资源的一组不同的操作。资源是服务器 上一个可命名的抽象概念,资源是以名词为核心来组织的,首先关注的是名词。REST要 求,必须通过统一的接口来对资源执行各种操作。对于每个资源只能执行一组有限的操 作。

7个HTTP方法:GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS
1、GET:表示获取,安全且幂等。
2、POST:表示创建资源,不安全且不幂等,因为一次请求添加一份新资源,二次请求则添加了两份新资源,多次请求会产生不同的结果。
3、PUT:表示更新资源,不安全但幂等。
4、DELETE:表示不安全但幂等。
总结:GET是安全的,其他情况都是不安全的;POST是不幂等,其他情况都是幂等。

状态码
1、200(OK)- 如果现有资源已被更改。
2、201(created)- 如果新资源被创建。
3、202(accepted)- 已接受处理请求但尚未完成(异步处理)
4、301(Moved Permanently)- 资源的URI被更新
5、303(See Other)- 其他(如,负载均衡)
6、400(bad request)- 指代坏请求
7、404(not found)- 资源不存在
8、406(not acceptable)- 服务端不支持所需表示
9、409(conflict)- 通用冲突
10、412(Precondition Failed)- 前置条件失败(如执行条件更新时的冲突)
11、415(unsupported media type)- 接受到的表示不受支持
12、500(internal server error)- 通用错误响应
13、502Bad Gateway错误、504 Bad Gateway timeout 网关超时。
14、503 (Service Unavailable)- 服务当前无法处理请求,通常,这只是暂时状态,比如线程池满了。

相关文章

  • RESTfull接口规范

    REST 是Representational State Transfer的缩写,翻译是”表现层状态转化”。 可以...

  • 接口设计评审规范

    接口设计评审规范 前言 本接口设计规范,参考了restfull的部分设计理念。 以资源为中心的接口设计 资源是 R...

  • Yii2构建RESTFull接口

    项目中用到了小程序调用RESTFull接口,故用Yii2快速实现一套RESTFull接口,需要的小伙伴直接拿走。 ...

  • RESTfull设计风格介绍

    1、认识RESTfull 在前后端分离的应用模式里,后端API接口如何定义? 需要一种规范和风格来约束后端程序员对...

  • Restfull API 示例

    什么是Restfull API Restfull API 从字面就可以知道,他是rest式的接口,所以就要先了解什...

  • RestTemplate踩坑笔记-中文乱码与json被解析成xm

    1.RestTemplate访问Restfull接口:中文乱码+返回数据格式为xml Spring Cloud项目...

  • 50. RESTful API的简单实现

    RESTfull API是现在很流行的 API 设计风格。众所周知的 HTTP 1.1规范正是基于 REST 架构...

  • 2019-10-14 SpringMVC与Servlet接口 S

    SpringMVC与Servlet接口 Servlet接口规范 Servlet 接口 定义servlet接口规范i...

  • API接口定义规范

    API接口定义规范 编写时间:2020年02月06号 基本接口共识来源于RESTful接口规范,在这个接口规范的基...

  • axios get 发送数组的坑

    起因,公司后台使用restfull 风格的api , 后台接口他们已经用个方法完全封装好了,所以所有 请求的得在前...

网友评论

      本文标题:RESTfull接口规范

      本文链接:https://www.haomeiwen.com/subject/mjxipqtx.html