RESTful API设计规范整理

随着微服务架构的流行,RESTful API也成了API事实上的标准,之前的SOAP也都转向RESTful API。 目前我参与的项目中使用 RAML 进行API设计。

在HTTP2的普及和互联网安全的威胁下, HTTP开始开始快速转向HTTPS(Chrome已对HTTP标记为不安全),RESTful API也推荐一定要使用SSL。

重点摘要

状态码

请求成功

重定向

重定向的新地址都需要在响应头  Location  中返回

条件请求

客户端错误

服务端错误

501 与 405 的区别是:405 是表示服务端不允许客户端这么做,501 是表示客户端或许可以这么做,但服务端还没有实现这个功能

相关资料:

请求方法

关于方法语义的说明:

参考 & 相关资源: