新增电视剧分集查询接口并更新第三方接口文档
- 新增 /openapi/partner/media/episodes 接口,通过父级 contentcode 查询电视剧分集列表,分集 contentcode 可作为 programCode 传入 SDK 获取播放地址 - JetsenMediaClient 新增 getEpisodes 方法,调橘视厅 getcontentlist.do 传 contentcode 参数获取分集 - API_DOC.md 补充 /list 多栏目查询、/list-all 全量聚合、/episodes 分集查询三个接口的详细文档
This commit is contained in:
111
API_DOC.md
111
API_DOC.md
@@ -281,8 +281,119 @@
|
||||
| `/openapi/partner/media/package` | GET | 无 | 查看授权范围 |
|
||||
| `/openapi/partner/media/catalog-tree` | GET | 无 | 栏目树(按授权过滤) |
|
||||
| `/openapi/partner/media/list` | GET | catalogid,pageindex,pagesize | 内容列表(按授权过滤) |
|
||||
| `/openapi/partner/media/list-all` | GET | parentCatalogid | 全量内容列表(按一级栏目聚合,不分页) |
|
||||
| `/openapi/partner/media/episodes` | GET | contentcode,pageindex,pagesize | 分集列表(通过父级contentcode) |
|
||||
| `/openapi/partner/media/search` | GET | keyword,pageindex,pagesize | 搜索(按授权过滤) |
|
||||
|
||||
#### 3.1.1 内容列表 `/list`
|
||||
|
||||
```
|
||||
GET /openapi/partner/media/list?catalogid=472&pageindex=1&pagesize=20
|
||||
```
|
||||
|
||||
**参数**:
|
||||
|
||||
| 参数 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| catalogid | String | 是 | 栏目id,支持逗号分隔传多个(如 `472,492,494`) |
|
||||
| pageindex | int | 否 | 页码,默认1 |
|
||||
| pagesize | int | 否 | 每页条数,默认20 |
|
||||
|
||||
**查询方式**:
|
||||
- 单栏目(`catalogid=472`):走橘视厅原生分页,响应快
|
||||
- 多栏目(`catalogid=472,492,494`):聚合各栏目全量内容后本地分页
|
||||
|
||||
**返回**:
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"list": [{"contentcode":"...", "name":"...", "posterimg":"...", "isFree":0, "episodecount":1}],
|
||||
"totalCount": 3227,
|
||||
"currPage": 1,
|
||||
"pageSize": 20,
|
||||
"totalPage": 162
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 3.1.2 全量内容列表 `/list-all`
|
||||
|
||||
```
|
||||
GET /openapi/partner/media/list-all?parentCatalogid=471
|
||||
```
|
||||
|
||||
一次请求返回某一级栏目(如471电影)下所有二级栏目合并后的全部内容,不分页。适合按天低频全量同步。
|
||||
|
||||
**参数**:
|
||||
|
||||
| 参数 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| parentCatalogid | String | 否 | 一级栏目id,默认471(电影) |
|
||||
|
||||
**返回**:
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"list": [{"contentcode":"...", "name":"...", "posterimg":"...", "isFree":0}],
|
||||
"totalCount": 3425,
|
||||
"parentCatalogid": "471"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
> 注:各二级栏目内容可能有跨栏目重复(一条内容可属多个栏目),第三方自行按 contentcode 去重。
|
||||
|
||||
#### 3.1.3 分集列表 `/episodes`
|
||||
|
||||
```
|
||||
GET /openapi/partner/media/episodes?contentcode=23010012026061709581101832&pageindex=1&pagesize=20
|
||||
```
|
||||
|
||||
传入电视剧的父级 contentcode,返回其下各分集列表。分集的 contentcode 可作为 programCode 传入 SDK 获取播放地址。
|
||||
|
||||
**参数**:
|
||||
|
||||
| 参数 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| contentcode | String | 是 | 父级内容编码(电视剧的 contentcode) |
|
||||
| pageindex | int | 否 | 页码,默认1 |
|
||||
| pagesize | int | 否 | 每页条数,默认20 |
|
||||
|
||||
**返回**:
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"list": [
|
||||
{
|
||||
"contentcode": "23010022026061709581131330",
|
||||
"name": "家有儿女第四部 1",
|
||||
"episodeindex": 1,
|
||||
"duration": 1531,
|
||||
"isFree": 0,
|
||||
"parentContentType": 1
|
||||
}
|
||||
],
|
||||
"totalCount": 67,
|
||||
"currPage": 1,
|
||||
"pageSize": 20,
|
||||
"totalPage": 4
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**关键字段**:
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| contentcode | 分集编码,作为 programCode 传入 SDK 获取播放地址 |
|
||||
| episodeindex | 集数索引,排序用 |
|
||||
| name | 集名 |
|
||||
| duration | 时长(秒) |
|
||||
| isFree | 是否免费(0=付费,1=免费) |
|
||||
|
||||
### 3.2 天卡代销 `/openapi/partner/card`
|
||||
|
||||
| 路径 | 方法 | 参数 | 说明 |
|
||||
|
||||
Reference in New Issue
Block a user