通用请求参数
有一些请求的参数在很多接口中都有用到,在此统一介绍。
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参数,也无效。