Api 如何创建映射操作的RESTful URI

Api 如何创建映射操作的RESTful URI,api,rest,Api,Rest,我在文档上有一个RESTAPI GET|POST|PUT|DELETE /documents/{id} 我应该实施适用于所有文档资源的“分发”操作 这一个伤害了我,因为“distribute”和“{id}”处于同一级别: POST /documents/distribute 我想知道实现动作URI的最佳实践是什么 谢谢 我将为分布式文档创建一个单独的资源: POST /distributed-documents/ -> {"document-id": 12345} 一种解决方案是在i

我在文档上有一个RESTAPI

GET|POST|PUT|DELETE /documents/{id}
我应该实施适用于所有文档资源的“分发”操作

这一个伤害了我,因为“distribute”和“{id}”处于同一级别:

POST /documents/distribute
我想知道实现动作URI的最佳实践是什么


谢谢

我将为分布式文档创建一个单独的资源:

POST /distributed-documents/
-> {"document-id": 12345}

一种解决方案是在id中添加前缀
GET | POST | PUT | DELETE/documents/doc-{id}
POST/distribute/documents
POST/documents?action=distribute
?“分发”操作到底会做什么?分发创建文档并通过电子邮件
POST/documents/\u distribute
分发文档可能是一个很好的折衷方案。即使请求外部不存在
分布式文档
,也可以将操作视为资源