Restful 风格,使用 PATH 定位资源,METHOD 区分操作
例子
以资源 Department 和其下的 Tags 为例
1、新增
# 新增一个 Department
-POST /Departments
# 给 Department 新增一个 Tag
-POST /Departments/{id}/Tags
2、获取
# 根据 id 获取 Department
-GET /Departments/{id}
# 获取某个 Department 的标签列表
-GET /Departments/{id}/Tags
3、更新
# 局部更新 Department
-PATCH /Departments/{id}
# 替换某个 Department 的标签列表
-PUT /Departments/{id}/Tags
4、删除
# 删除 Department
-DELETE /Departments/{id}
# 删除 Department 的某个 Tag
-DELETE /Departments/{id}/Tags/{tag}
5、其他操作
# 其他特殊的操作使用 POST 请求,路径设计为 _动作,如
-POST /Reports/{id}/_submit
-POST /Reports/{id}/_change