在RESTful URL中使用动词和形容词的替代方法

Question

/resources
/resources/{resourceId}

POST /resources/{resourceId}/deactivate   

或者：

POST /resources/deactivated/{resourceId}

获取所有停用的对象：

GET /resources/deactivated      

反转“deactivated”操作，即从概念上将对象从“/resources/deactivated/”子文件夹移回主文件夹（“/resources”）。

POST /resources/{resourceId}/reactivate    

POST /resources/deactivated/{resourceId}/restore     

我可以找到关于这个主题的好资源：

• Rest URL中名词与动词的混淆
• GitHub的动词用法（POST/gists/：id/star,DELETE/gists/：id/star）:https://stackoverflow.com/a/19648997/1847482
• 关于需要查找“另一个对象类型”的好观点:https://stackoverflow.com/A/2022938/1847482

Answer 1

首先，记住REST代表表征状态转移。

这一切都是关于资源及其状态的。像激活、停用和移动这样的操作都是关于用新的表示形式替换资源的当前状态的，您不需要URL中的动词来表示这样的操作。

例如，要替换资源的状态，可以在Put请求的有效负载中发送资源的新表示形式：

PUT /api/resources/[id]/status HTTP/1.1
Host: example.org
Content-Type: application/json

{ "status" : "active" }

GET /api/resources?status=active HTTP/1.1
Host: example.org
Accept: application/json

PUT /api/resources/[id]/folder HTTP/1.1
Host: example.org
Content-Type: application/json

{ "target" : "draft" }