Skip to content

分页

范围式

请求

参数名称类型字段描述
offsetinteger指定返回记录的开始位置
limitinteger指定返回记录的数量

例如:

GET ?offset=0&limit=10

响应

参数名称类型字段描述
totalinteger符合筛选条件的数据总条数
itemsarray指定起止位的数据内容,如果没有符合筛选条件的数据,则为空数组

例如:

HTTP/1.1 200 OK
Content-Type: application/json
json
{
    "total": 910,
    "items":[{}, {} ...]
}

迭代式

请求

参数名称类型字段描述
page_sizeinteger指定返回记录的数量
page_tokenstring指定返回特定页面

例如

GET ?page_size=10&page_token=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA

响应

参数名称类型字段描述
next_page_tokenstring下一页结果的分页令牌

例如:

HTTP/1.1 200 OK
Content-Type: application/json
json
{
    "next_page_token": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
    "items":[{}, {} ...]
}

基于 VitePress 构建