restfulAPI接口——HTTP地址解析

一、HTTP动词

对于资源的具体操作类型，由HTTP动词表示。

常用的HTTP动词有以下四个：

• GET：从服务器取出资源（一项或多项）。

• POST：在服务器新建一个资源。

• PUT：在服务器更新资源。（客户端提供改变后的完整资源）

• DELETE：从服务器删除资源。

还有三个不常用的HTTP动词：

• PATCH：在服务器更新资源（客户端提供改变的属性，部分资源）。

• HEAD：获取资源的元数据。

• OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的。

GET/class:获取所有班级

POST/class：新建一个班级

PUT/class/ID：更新编号为ID的班级的所有信息

PATCH/class/ID:更新编号为ID的班级的的部分信息

GET/class:获取所有班级
POST/class：新建一个班级
PUT/class/ID：更新编号为ID的班级的所有信息
PATCH/class/ID:更新编号为ID的班级的的部分

二、过滤信息（Filtering）

完整的URL地址格式：

协议：//域名（IP）：端口号/路径/?查询字符串#锚点

查询字符串：query_string

格式与请求体类型：

username=xiaoming&class=8

三、状态码（Status Codes）

• 1xx 表示当前本次请求还是持续的，没结束

• 2xx 表示当前本次请求成功/完成了

• 3xx 表示当前本次请求成功，但是服务器进行代理操作/重定向

• 4xx 表示当前本次请求失败，主要是客户端发生了错误

• 5xx 表示当前本次请求失败，主要是服务器发生了错误

四、错误处理（Error）

如果状态码是4xx或5xx，服务器就应该向用户返回错误信息。一般错误信息格式都是json格式，error作为键名，错误信息作为键值。