java - 在 REST api 中一次发布复杂对象还是逐步添加子资源？

Question

假设您有一个应用 RESTful 原则构建的 Web 服务。您有一个 URL，您也可以发布新文章。 /articles 是路径。

每篇文章都包含标题、日期、描述等...(原始值)以及更复杂的关系，如文章应放置的类别、位置等。

当您在资源创建后对资源执行 GET 操作时，例如/articles/123456 你会得到一个 JSON 格式的响应，其中包含所有原始数据，如标题等，以及包含位置、类别等 URL 的简单字段。我没有在文章中嵌入这些数据。

但是，当您创建新文章时，正确的做法是什么？我应该嵌入类别、位置等(更像是与其他复合对象的关系的东西)还是应该先发布包含简单数据的新文章，然后逐步向其中添加数据？

例如/articles/123456/categories POST？

或者这是否取决于说明创建文章需要哪些数据的业务需求？你会怎么办？

Answer 1

拥有可变的子资源(或集合)可能有用，也可能没有用。想一想 API 消费者，他将如何使用您的 API？还要考虑相关资源的生命周期；这些实体可以独立生存吗？考虑到这些事情，您应该可以很好地了解是否需要能够自行改变这些子资源/集合。无论如何，我会说从小处着手，在一个合理的起点上将这些资源与文章本身一起发布(并将它们与文章一起获取)。您始终可以添加 API 方法以在以后更改/查询子资源/集合。