什么是restful？

restful是当下最流行的接口设计规范，前端和后端都必须知道的一种规范
该规范定义了接口开发中，各个流程之中

协议

客户端在通过 API 与后端服务通信的过程中，应该 使用 HTTPS 协议

域名

API 应该部署在专用域名之下，应尽可能保持足够简单。如果确定 API 很简单，不会有进一步扩展，可以考虑放在主域名下，这里有两个常见的 URL 根例子：

• api.example.com/* 单独一个子域名用来访问接口
• example.com/api/* 主域名之下单独一个空间

版本（Versioning）

所有的 API 必须保持向后兼容，你 必须 在引入新版本 API 的同时确保旧版本 API 仍然可用。所以 应该 为其提供版本支持

地址（path） 路由（router）

API 的具体网址

• URL 的命名 必须 全部小写
• URL 中资源（resource）的命名 必须 是名词，并且 必须 是复数形式
• 必须 优先使用 Restful 类型的 URL
• URL 必须 是易读的
• URL 一定不可 暴露服务器架构

至于 URL 是否必须使用连字符（-） 或下划线（_），不做硬性规定，但 必须 根据团队情况统一一种风格

• https://api.example.com/zoos
• https://api.example.com/animals
• https://api.example.com/zoos/{zoo}/animals
• https://api.example.com/animal_types
• https://api.example.com/employees

动词（请求方法 method）

对于资源的具体操作类型，由 HTTP 动词表示。常用的 HTTP 动词有下面五个（括号里是对应的 SQL 命令）。

• GET（SELECT）：从服务器取出资源（一项或多项）。
• POST（CREATE）：在服务器新建一个资源。
• PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）全更新。
• PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）部分更新。
• DELETE（DELETE）：从服务器删除资源。

url参数

所有 URL 参数 必须 是全小写，必须 使用下划线类型的参数形式
分页参数 必须 固定为 page、page_size

响应（Response）

必须 选择合适的 HTTP 状态码。
必须 返回 JSON 格式数据。
所有错误必须统一错误格式。

常见的状态码

• 1xx 代表请求已被接受，需要继续处理 api中一般不出现
• 2xx 请求已成功，请求所希望的响应头或数据体将随此响应返回
  • 200 服务器成功返回用户请求的数据
  • 201 用户新建或修改数据成功
  • 202 表示一个请求已经进入后台排队（成功了没有返回值，是一个异步）
  • 204 删除成功
• 3xx 重定向
• 4xx 客户端原因引起的错误
  • 404 请求的接口不存在，错误类型（请求地址错了）
  • 401 用户未登录
  • 403 用户登录了，但是没有权限访问
  • 422 客户端参数错误，验证错误
  • 429 超出请求限制
• 5xx 服务端原因引起的错误
  • 500 服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理，服务端代码报错
  • 503 服务器维护之中
  • 504 超时调用

错误格式

'message' => ':message',          // 错误的具体描述
'errors' => ':errors',            // 参数的具体错误描述，422 等状态提供
'code' => ':code',                // 业务自定义的异常码
'status_code' => ':status_code',  // http状态码
'debug' => ':debug',              // debug 信息，非生产环境提供

什么是报文？

HTTP报文时是HTTP进行请求和响应时用来交换信息的。报文是由客户端流入服务器的

报文分为两类：请求报文，响应报文

请求和响应报文的基本报文结构相同，都是由三部分组成：

• 起始行：对报文进行描述
• 首部：一些属性
• 主体：数据【可选】

axios

兼容浏览器和node服务器
从浏览器中创建 XMLHttpRequests
从 node.js 创建 http 请求

支持 Promise API
支持拦截请求和响应
转换请求数据和响应数据
取消请求
自动转换 JSON 数据
客户端支持防御 XSRF