jsonapi.org使用分页使用页面查询字符串

Question

在documentation for jsonapi的分页正确的方法是说以下内容：

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

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

Answer 1

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

你是对的技术上，这就是为什么该规范有写着注意事项：

注：例如查询参数上面使用未编码的[和]字符仅为可读性。在实践中，这些字符必须是百分比编码，按要求在RFC 3986.

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

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

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