通用请求参数
有一些请求的参数在很多接口中都有用到,在此统一介绍。
pn & ps
参数名 | 数据类型 | 是否必须 | 默认值 | 取值范围 | 备注 |
---|---|---|---|---|---|
pn | Integer | 否 | 1 | x > 0 | page num,表示请求的页码,与ps一起使用 |
ps | Integer | 否 | 取决于具体API | 0 < x < (取决于具体API) | page size,表示每页包含的对象数,与pn一起使用 |
返回的项目排序序号:第(pn - 1) * ps
~ 第pn * ps - 1
条,共ps
条。
last_count
参数名 | 数据类型 | 是否必须 | 默认值 | 取值范围 | 备注 |
---|---|---|---|---|---|
last_count | Integer | 否 | 0 | 0 <= x <= 5000 | 请求返回最后添加的x条记录,默认值0为不设置该参数 |
[!NOTE]
last_count
与pn
和ps
互斥,且拥有更高的优先级,即如果声明了last_count
,期望返回最近添加的若干条记录,则即使设置了pn
与ps
参数,也无效。