列表翻頁

很多時候，當您調用 SiteServer REST API 時，會返回很多結果，因此，我們需要對結果進行分頁，以確保響應更容易處理。

假設你需要獲取整個網站的內容列表，其結果可能是數十萬頁的大規模回應，這可能導致長時間的等待以及服務器性能受到影響；所以，我們在返回列表時使用了默認的限制（默認返回 20 個結果），但是你可以通過顯式地設置限制參數，以確保獲得指定數量的結果。

設置限制參數

客戶端發起API請求時可以使用top和skip查詢參數來指定要返回的結果和集合中的偏移量。

當客戶端同時提供top和skip參數時，服務器會首先應用skip，然后在集合上應用top。

以下限制參數可用于所有獲取列表的API中，如獲取用戶API、獲取內容列表API等。

參數名	位置	類型	默認值	說明
top	query	整數	20	返回的結果數量
skip	query	整數	0	集合中的偏移量

請求示例1

請求獲取指定站點下的前30篇內容

GET /api/v1/contents/1325?top=30 HTTP/1.1Copy to clipboardErrorCopied

請求示例2

請求獲取指定站點下的第6到15篇內容，同時

GET /api/v1/contents/1325?top=10&skip=5 HTTP/1.1Copy to clipboardErrorCopied

獲取翻頁結果

分頁響應將通過在響應中包含指定的值來返回翻頁所需的數據，如總條數、上一頁地址、下一頁地址等。缺少對應的值意味著沒有其他頁面可用。

返回結果	類型	說明
value	數組	翻頁結果列表
first	字符串	第一頁的API訪問地址
prev	字符串	上一頁的API訪問地址
next	字符串	下一頁的API訪問地址
last	字符串	最后一頁的API訪問地址
count	整數	總條數

響應示例

{     "value": [         {             "id": 2221,             "channelId": 1344,             "siteId": 1325,             "addUserName": "admin",             "lastEditUserName": "admin",             "writingUserName": "",             "lastEditDate": "2017-04-10 08:50:00",             "taxis": 6,             "groupNameCollection": "",             "tags": "",             "sourceId": 0,             "referenceId": 0,             "isChecked": "True",             "checkedLevel": 0,             "hits": 0,             "hitsByDay": 0,             "hitsByWeek": 0,             "hitsByMonth": 0,             "lastHitsDate": "2017-04-02 15:49:00",             "settingsXml": "titleformatstring=True_False_False_&check_isadmin=True&check_username=admin&check_checkdate=2017-04-02 下午 3:49",             "title": "標題6",             "isTop": "False",             "isRecommend": "False",             "isHot": "True",             "isColor": "False",             "linkUrl": "",             "addDate": "2017-04-02 15:49:00",             "subTitle": "",             "imageUrl": "//127.0.0.1/test17/upload/images/2018/4/7765a380c3d18abd.jpg",             "videoUrl": "",             "fileUrl": "",             "content": "",             "summary": "",             "author": "",             "source": "",             "titleformatstring": "True_False_False_",             "check_isadmin": "True",             "check_username": "admin",             "check_checkdate": "2017-04-02 下午 3:49",             "navigationUrl": "//127.0.0.1/test17/news/201804/2221.html"         },         {             "id": 2223,             "channelId": 1344,             "siteId": 1325,             "addUserName": "admin",             "lastEditUserName": "admin",             "writingUserName": "",             "lastEditDate": "2017-05-06 11:05:00",             "taxis": 8,             "groupNameCollection": "",             "tags": "其他",             "sourceId": 0,             "referenceId": 0,             "isChecked": "True",             "checkedLevel": 0,             "hits": 5,             "hitsByDay": 2,             "hitsByWeek": 2,             "hitsByMonth": 2,             "lastHitsDate": "2017-06-15 00:00:00",             "settingsXml": "titleformatstring=False_False_False_&check_isadmin=True&check_username=admin&check_checkdate=2017-04-02 下午 3:49",             "title": "標題8",             "isTop": "False",             "isRecommend": "False",             "isHot": "True",             "isColor": "False",             "linkUrl": "",             "addDate": "2017-04-02 15:49:00",             "subTitle": "",             "imageUrl": "//127.0.0.1/test17/upload/images/2018/4/2a131c625f84a37d.jpg",             "videoUrl": "@/upload/videos/2018/5/acddd7e04837d00c.mp4",             "fileUrl": "//127.0.0.1/test17/upload/images/2018/5/d9241fe1de65d4ea.jpg",             "content": "<p><img src=\"@/upload/images/2018/5/de0480c38737bbde.png\"/><img src=\"@/upload/images/2018/5/213add0d1ccf20e2.jpg\" title=\"ISO9001中文.jpg\" alt=\"ISO9001中文.jpg\"/><img src=\"@/upload/images/2018/5/7d2250f2955d1c09.png\"/></p>",             "summary": "",             "author": "",             "source": "",             "titleformatstring": "False_False_False_",             "check_isadmin": "True",             "check_username": "admin",             "check_checkdate": "2017-04-02 下午 3:49",             "navigationUrl": "//127.0.0.1/test17/news/201804/2223.html"         }     ],     "first": "//localhost/api/v1/contents/1325?top=2&skip=0",     "prev": "//localhost/api/v1/contents/1325?top=2&skip=0",     "next": "//localhost/api/v1/contents/1325?top=2&skip=4",     "last": "//localhost/api/v1/contents/1325?top=2&skip=6",     "count": 8 }

本頁內容由塔燈網絡科技有限公司通過網絡收集編輯所得，所有資料僅供用戶參考了本站不擁有所有權，如您認為本網頁中由涉嫌抄襲的內容，請及時與我們聯系，并提供相關證據，工作人員會在5工作日內聯系您，一經查實，本站立刻刪除侵權內容。本文鏈接://sammigames.com/18186.html