RESTful接口规范

HTTP动词

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

常见的五个HTTP动词（括号对应SQL命令）

• GET (读取): 从服务器取出资源（一项或者多项）。
• POST(创建): 在服务器新建一个资源。
• PUT(完整更新): 在服务器更新一个资源（客户端提供改变后的完整资源）。
• PATCH(部分更新): 在服务器更新一个资源（客户端提供改变的属性）。
• DELETE(删除): 从服务器删除资源。

HTTP状态码

客户端每一次请求，服务区都必须给出回应。回应包括HTTP状态码和数据两部分。

HTTP状态码就是一个三位数，分成五个类别。

• 1XX:相关信息
• 2XX:操作成功
• 3XX:重定向
• 4XX:客户端错误
• 5XX:服务器错误

常见状态码：（方括号中对应该状态码的HTTP动词）

• 200 OK - [GET]：服务器成功返回用户请求的数据。
• 201 CREATED - [POST、PUT、PATCH]：用户新建或修改数据成功。
• 204 NO CONTENT - [DELETE]：用户删除数据成功。
• 401 Unauthorized - [ * ]：表示用户没有权限（令牌、用户名、密码错误）。
• 403 Forbidden - [ * ]：表示用户得到授权（与401错误相对），但是访问是被禁止的，比如管理员权限操作。
• 404 NOT FOUND - [ * ]：用户发出的请求真的的是不存在的记录，服务器没有进行操作，也就是常见的404页面。
• 500 INTERNAL SERVER ERROR - [ * ]：服务器内部错误.