1. 路径
在RESTful架构中,每一个网址代表一种资源,所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表格名对应。一般来说,数据库中的表都是同种记录的集合,所以API中的名词也应该使用复数。
2. HTTP动词
动词 | 对应SQL命令 | 备注 |
---|---|---|
GET | 读取 | 从服务器取出资源 |
POST | 创建 | 在服务器中新建一个资源 |
PUT | 完整更新 | 在服务器更新资源 |
PATCH | 部分更新 | 在服务器更新资源 |
DELETE | 删除 | 从服务器删除资源 |
3. 状态码
1xx | 相关信息 |
2xx | 操作成功 |
3xx | 重定向 |
4xx | 客户端错误 |
5xx | 服务器错误 |
常见状态码:
- 401:表示用户没有权限。
- 403:表示用户得到授权,但是访问是被禁止的。
- 404:资源不存在。
- 500:服务器发生错误。