api - 嵌套资源也需要分页吗？

Question

我正在构建一个 REST api。我要解决的问题的一个简单示例涉及 2 个域实体:帖子和评论。当前对 http://myapidomain.com/posts 的 GET 请求返回一个帖子集合，其中每个帖子都包含指向关于该特定帖子的评论的链接。我还将允许在响应中扩展评论链接，以便评论列表按行显示，而不是指向它们的 url。每种方法都有利弊，但有充分的理由包括这两种选择。

我的问题是，例如我对/posts 的 GET 请求返回一个分页列表(例如，页面大小为 10)，其中包含评论列表，而不仅仅是一个链接……我需要吗也要对嵌套资源进行分页？我担心单个帖子可以有无限数量的评论，因此 10 个帖子的列表可能有一个或多个帖子，其中一个帖子有 100 条评论。那么内部/嵌套资源是否也需要分页，或者是否有一些标准方法来处理这种情况？

Answer 1

包含集合子资源的链接是一种很好的做法。如果客户端需要收集，可以对链接执行新的请求。

但是，如果出于某种原因，您需要为每个帖子预加载一些评论，我会考虑只包含评论的第一页并提供加载下一页的链接。

{
  "data": [
    {
      "id": 1,
      "title": "It's a post",
      "content": "Lorem ipsum dolor sit amet, consectetur adipiscing elit...",
      "comments": {
        "data": [
          {
            "content": "It's a comment",
            "author": "John Doe"
          },
          {
            "content": "It's comment",
            "author": "Jane Doe"
          },
          ...
        ],
        "paging": {
          "next": "http://api.example.com/posts/1/comments?page=2&size=10"
        }
      }
    },
    ...
  ],
  "paging": {
    "previous": "http://api.example.com/posts?page=1&size=10",
    "next": "http://api.example.com/posts?page=3&size=10"
  }
}