jsonapi.org 使用页面查询字符串使用分页的正确方法

Question

在documentation for jsonapi进行分页是这样说的：

例如，基于页面的策略可能会使用查询参数，例如 page[number] 和 page[size]

我将如何在查询字符串中表示它？ http://localhost:4200/people?page[number]=1&page[size]=25，我不认为使用地图链接结构是有效的查询字符串。根据文档只保留page参数。

Answer 1

我不认为使用地图链接结构是有效的查询字符串。

从技术上讲你是对的，这就是为什么规范有这样的注释：

注意：上面的示例查询参数使用未编码的[ 和] 字符只是为了便于阅读。实际上，这些字符必须按照 RFC 3986 中的要求进行百分比编码。

所以，page[size] 实际上是 page%5Bsize%5D，这是一个有效的查询参数名称。

根据文档只保留页面参数。

当规范文本说只保留页面时，实际上意味着任何page[......] 样式查询参数都被保留。 （作为规范的编辑之一，我可以肯定地告诉你。）但它应该更明确地说，所以我会为它打开一个问题。