API分页标准

Question

我一直在研究 API，需要分页。每个请求仅返回 25 个元素。我正在四处寻找标准，我似乎看到了两种不同的情况。

1. 链接头

• 链接：https://www.rfc-editor.org/rfc/rfc5988

例子：

Link: <https://api.github.com/user/repos?page=3&per_page=100>; rel="next",
  <https://api.github.com/user/repos?page=50&per_page=100>; rel="last"

---

1. 在 JSON 响应中

• 链接：API pagination best practices

例子：

"paging":  {
    "previous":  "http://api.example.com/foo?since=TIMESTAMP"
    "next":  "http://api.example.com/foo?since=TIMESTAMP2"
}

问题：

我应该两者都做吗？话虽如此；键“分页”是正确的键吗？或“链接”或“分页”

Answer 1

我会说这取决于您返回的数据结构（并且可能在将来返回）。

如果您从来没有嵌套对象需要自己的链接，那么使用 Link 标头（稍微）更可取，因为它更正确。嵌套对象的问题是你不能嵌套链接头。

考虑以下集合实体：

{
    "links": {
        "collection": "/cards?offset=0&limit=25"
    },
    "data": [
        {
            "cardName": "Island of Wak-Wak",
            "type": "Land",
            "links": {
                "set": "/cards?set=Arabian Knights"
            }
        },
        {
            "cardName": "Mana Drain",
            "type": "Interrupt",
            "links": {
                "set": "/cards?set=Legends"
            }
        }
    ]
}

没有好的方法可以在标题中包含卡片的链接。