分頁

分頁

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

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

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

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

如果是第一頁或者是最后一頁時(shí)，不會(huì)返回?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