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 的角度来看，什么 路线还有什么 动词 应该用于这种操作？我应该为回滚操作创建一个新动词吗？

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

Answer 1

由于您拥有每个可用版本的表示，并且回滚操作应该是幂等的，因此最直接的方法是简单地执行 PUT至 document/[id]与 GET document/[id]/revision/[revisionid] 的内容，为 revisionid你要document/[id]要设置为。