REST_API

REST_API简介

1.设计概念和准则

网络上的所有事物都可以被抽象为资源

每一个资源都有唯一的资源标识，对资源的操作不会改变这些标识

所有的操作都是无状态的。

2.REST_API中http协议

请求：请求行、消息报头、请求正文

请求方式：get、post、head(请求获取由Request-URI所标识的资源的响应消息报头)、put、delete、options(查询服务器性能，查询与资源相关的选项和需求时用到)。

响应：状态行、消息报头、响应正文

常用状态码：

200 成功

400 客户端请求有语法错误，不能被服务器所理解

401 服务器接受请求后拒绝提供服务

404 请求资源不存在

500 服务器发生错误

503 服务器单前不能处理客户端的请求

3.1RESTful API设计

资源路径

每个网址代表一种资源 协议头 域名 版本号 资源名

http动词

对资源的CURD操作。put 返回所有信息 patch 返回修改的信息

过滤信息

返回结果太多的情况下根据特定条件进行筛选

状态码

200 服务器成功返回用户请求的数据

201 新建或者修改数据

204 删除数据

400 用户发出的请求有错误

401 表示用户没有认证，无法进行当前操作

403 表示用户访问是被禁止的。

422 创建对象时，发生了验证错误

500 服务器错误

错误处理

进行相应的提示，对5xx错误进行隐藏显示，避免暴露敏感信息

返回结果

返回对于的状态码和信息

3.2 DHC client 插件

（接口开发工具，相当于postman）