接口的概念
接口:数据交互的入口和出口,是一套规范一套标准
接口的优点:
- 统一的设计标准
- 前后端开发相对独立
- 具有扩展性灵活性
- 前后端都可以使用自己熟悉的技术
接口测试
接口测试:代替前端或者第三方验证后台响应数据是否正确(测试后端实现是否符合接口规范)
接口一般需要满足RESTful风格,该风格规范了URL的实现方式,提交的数据的实现方式,响应数据的实现方式
RESTful风格约束接口的四种操作以及三个要素
- 增:要素1:URL+POST;要素2:键=值&键=值或json格式;要素3:200|201+添加的记录
- 删:要素1:URL+DELETE(标准)|GET;要素2:键=值&键=值;要素3:200|204+无
- 改:要素1:URL+POST|PUT(PUT更合适);要素2:键=值&键=值或json格式;要素3:200|201+修改后那条数据
- 查:要素1:URL+GET;要素2:URL后跟?键=值&键=值;要素3:200+一条或多条记录
API返回的状态码含义,加粗为常见的
可参考https://www.php.cn/web/web-http101.html
1xx 消息:
----代表请求已被接受,需继续处理
- 100:Continue,客户端应继续发送请求
- 101:Switching Protocols,表示切换协议
- 102:Processing,处理将被继续执行
2xx 成功
- 200:OK,请求已成功
- 201:Created,请求已被实现,一个新的资源被创建
- 202:Accepted,已接受,尚未处理,多用于异步操作
- 203:已成功处理,但头部无信息,是本地或第三方
- 204:成功处理,不需要返回内容
- 205:成功处理,一般用于重置表单
3xx 重定向
4xx 客户端错误
- 400:请求消息语法错误
- 401:身份验证错误
- 403:资源存在,但没有访问权限
- 404:资源路径错误
- 405:请求方法错误
5xx 服务器错误
- 500:服务器程序码出错
- 501:服务器无法识别请求方法
- 502:上游服务器无效响应
- 503:服务器无法处理请求(临时状态)
- 504:上游服务器响应超时
- 505:服务器不支持在请求中使用HTTP请求