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[......]樣式查詢參數都是保留的。 （我可以肯定地告訴你，作爲規範的編輯之一。）但它應該更明確地說，所以我會爲它打開一個問題。