rest - 您如何表示 RESTful 资源的 "thin"和 "fat"版本？

Question

您将如何对可以具有两种不同表示形式的资源进行建模。例如，一种表示可能是“瘦”的，其大部分相关资源可通过链接访问。另一种表示可能是“胖”，其中嵌入了其大部分相关资源。这个想法是，一些客户不介意必须多次调用来浏览链接的资源，但其他客户希望一次获得所有数据。

考虑与导演、 Actor 等相关联的电影资源。也许它的精简版本只有电影标题，并且要获取导演、 Actor 名单等的数据，必须通过嵌入到它们的链接。也许它的胖版本包含嵌套在里面的所有电影，包括导演的数据，各个 Actor 的数据等。

应该如何建模？

我看到几个选项:

这两种表示实际上是两种不同的资源，需要不同的 URI

这两种表示实际上是相同的资源，您可以通过自定义媒体类型在两种表示之间进行选择，例如 application/vnd.movie.thin+json和 application/vnd.movie.fat+json .

这两种表示实际上是相同的资源，应该使用查询参数(例如 /movies/1?view=thin )来选择不同的表示。

还有什么...

您认为这种 API 的正确方法是什么？

Answer 1

您可以使用 prefer header与返回最小参数。