清理 REST 路由

Question

我不确定我的 REST 命名。

我有 3 条路线：

GET 和 DELETE 和 PUT /book/:bookId/translation/:translationId

通过 GET 我得到一本书的翻译。 DELETE 我删除了一本书的翻译。并且使用 PUT 我更改了翻译。

但是 POST 路由的命名如何呢？ 通过 POST，我将为一本书创建新的翻译。

最好是 /book/:bookId 还是 /book/:bookId/translation

非常感谢您的反馈！

Answer 1

最好是 /book/:bookId 还是 /book/:bookId/translation

由于以下原因，/book/:bookId/translation 似乎最适合 POST 新翻译：

1. 您正确指定了您要发布的内容（特定图书 ID 的翻译）。
2. 这与您使用/book/:bookId/translation/:translationId 查询翻译的方式一致。
3. 这与您通过在 /book/:bookId/translation 上执行 GET 来查询翻译列表的方式一致。
4. 这个整体方案的意义在于它是什么类型的对象，然后是对象 id，然后是什么类型的子对象。