分頁

請求某個資源集合時，可以通過指定?count?參數(shù)來指定每頁的資源數(shù)量，通過?page?參數(shù)指定頁碼，或根據(jù)?last_cursor?參數(shù)指定上一頁最后一個資源的標(biāo)識符。

如果沒有傳遞?count?參數(shù)或者?count?參數(shù)的值為空，則使用默認(rèn)值 20 ，?count?參數(shù)的最大上限為 100 。

如何同時傳遞了?last_cursor?和?page?參數(shù)，則使用?page?。

分頁的相關(guān)信息會包含在?Link Header?和?X-Total-Count?中。

如果是第一頁或者是最后一頁時，不會返回?previous?和?next?的 Link 。

HTTP/1.1 200 OK
X-Total-Count: 542
Link: <http://api.example.com/#{RESOURCE_URI}?last_cursor=&count=100>; rel="first",
      <http://api.example.com/#{RESOURCE_URI}?last_cursor=200&count=100>; rel="last"
      <http://api.example.com/#{RESOURCE_URI}?last_cursor=90&count=100>; rel="previous",
      <http://api.example.com/#{RESOURCE_URI}?last_cursor=120&count=100>; rel="next",

[
  ...
]

相關(guān)資料：

• RFC 5005 第3節(jié)?Paged Feeds
• RFC 5988 6.2.2節(jié)?Initial Registry Contents