rest - 在 RESTFul API 中，还原/回滚操作的正确 http 动词是什么？

Question

想象一个简单的文档管理 Web 服务，其结构如下：

document/  
    GET -> retrieves all documents
    POST -> creates a new document

document/[id]
    GET -> retrieves the "latest" revision of document specified by ID
    POST -> creates a new revision of the document

document/[id]/revision
    GET -> retrieves all revisions of the document
    POST -> Alias to POST->document/[id]

document/[id]/revision/[revisionID]
    GET -> retrieves the specified revision of the document

现在，假设我想将文档回滚到以前的任意修订版（例如，从修订版 5 到 3）。

从 RESTful 的角度来看，这种操作应该使用什么ROUTE和什么VERB ？我应该为回滚操作创建一个新动词吗？

请记住，在回滚操作中不会删除任何内容。在内部，服务器只是将不同的修订号识别为最新的。

Answer 1

由于您拥有每个可用修订版的表示，并且回滚操作应该是幂等的，因此最直接的方法是简单地对您想要设置的 , 的内容做一个PUTto 。document/[id]GET document/[id]/revision/[revisionid]revisioniddocument/[id]