Restful 风格

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