7.获取所有书籍授权状态
获取所有书籍授权状态
-
URL: /open/resource/bookStatusList
-
命令: HTTP GET/POST
-
说明: 该接口可拉取接入方授权过的所有书籍的授权状态,接入方应定时刷新该接口来更新处理书籍授权状态
接入方可定时全量拉取所有授权书籍列表来更新控制本地书籍上下架,也可以根据authStatus字段与afterTime字段增量拉取授权和未授权的书籍列表来更新控制本地书籍上下架 -
Request 参数格式
| 参数名称 | 参数类型 | 参数说明 | 必传 |
|---|---|---|---|
| referId | String | 翻页游标,第一次可传零或者不传,第二次为第一次接口返回值中referId | 否 |
| authStatus | int | 授权状态,不传则表示查询所有状态。0-禁止访问,1-正常授权,2-取消授权 | 否 |
| afterTime | long | 表示查询该时间之后有更新授权的实体,不传表示所有。时间戳(精确到毫秒) | 否 |
| size | int | 本页数量,默认100 | 否 |
- Response格式
| 参数名称 | 参数类型 | 参数说明 |
|---|---|---|
| status | int | 状态码,0表示成功 |
| msg | String | 描述信息 |
| data | Object | 数据信息 |
- data格式
| 参数名称 | 参数类型 | 参数说明 |
|---|---|---|
| referId | String | 当referId == end 时,表示数据已请求完,无需下次访问 |
| list | Object[] | 书籍授权状态信息列表 |
- 书籍授权状态对象
| 参数名称 | 参数类型 | 参数说明 |
|---|---|---|
| id | long | 书籍ID |
| authStatus | int | 授权状态,0-禁止访问,1-正常授权,2-取消授权;取消授权和禁止访问的书籍,第三方应把书籍处理下架 |