From 73d0d42e8fcf38e2a664a36adfa218198239448d Mon Sep 17 00:00:00 2001 From: zhaogd Date: Wed, 29 Jul 2026 12:19:05 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=A9=98=E8=A7=86=E5=8E=85?= =?UTF-8?q?=E9=85=92=E5=BA=97=E7=89=88openapi=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 媒资接口补充 /list 多栏目查询、/list-all 全量聚合、/episodes 分集查询接口说明 - curl 示例补充对应接口调用示例，调整章节编号 --- 橘视厅酒店版openapi文档.md | 72 ++++++++++++++++++++++++++++++++++---- 1 file changed, 66 insertions(+), 6 deletions(-) diff --git a/橘视厅酒店版openapi文档.md b/橘视厅酒店版openapi文档.md index b7a71e4..972072b 100644 --- a/橘视厅酒店版openapi文档.md +++ b/橘视厅酒店版openapi文档.md @@ -210,15 +210,55 @@ GET /openapi/partner/media/list?catalogid=472&pageindex=1&pagesize=20 | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| -| catalogid | String | FULL/CATALOG 级别必填 | 栏目 ID | +| catalogid | String | FULL/CATALOG 级别必填 | 栏目 ID，支持逗号分隔传多个（如 `472,492,494`）| | pageindex | int | 否（默认 1）| 页码 | | pagesize | int | 否（默认 20）| 每页条数 | - CONTENT 级别：返回授权内容列表，不需传 catalogid -- CATALOG 级别：必须传授权范围内的 catalogid +- CATALOG 级别：必须传授权范围内的 catalogid（多栏目时每个都需在授权范围内） - FULL 级别：必须传 catalogid +- 单栏目：走橘视厅原生分页，响应快 +- 多栏目（逗号分隔）：聚合各栏目全量内容后本地分页 -### 4.4 搜索 +### 4.4 全量内容列表 + +``` +GET /openapi/partner/media/list-all?parentCatalogid=471 +``` + +一次请求返回某一级栏目（如 471 电影）下所有二级栏目合并后的全部内容，不分页。适合按天低频全量同步。 + +| 参数 | 类型 | 必填 | 说明 | +|------|------|------|------| +| parentCatalogid | String | 否（默认 471）| 一级栏目 ID | + +> 注：各二级栏目内容可能有跨栏目重复（一条内容可属多个栏目），第三方自行按 contentcode 去重。 + +### 4.5 分集列表 + +``` +GET /openapi/partner/media/episodes?contentcode=23010012026061709581101832&pageindex=1&pagesize=20 +``` + +传入电视剧的父级 contentcode，返回其下各分集列表。分集的 contentcode 可作为 programCode 传入 SDK 获取播放地址。 + +| 参数 | 类型 | 必填 | 说明 | +|------|------|------|------| +| contentcode | String | 是 | 父级内容编码（电视剧的 contentcode）| +| pageindex | int | 否（默认 1）| 页码 | +| pagesize | int | 否（默认 20）| 每页条数 | + +- CONTENT 级别：校验 contentcode 在授权范围内 +- CATALOG/FULL 级别：直接返回 + +分集额外字段： + +| 字段 | 说明 | +|------|------| +| episodeindex | 集数索引，排序用 | +| parentContentType | 内容类型 | + +### 4.6 搜索 ``` GET /openapi/partner/media/search?keyword=镖人&pageindex=1&pagesize=20 @@ -230,7 +270,7 @@ GET /openapi/partner/media/search?keyword=镖人&pageindex=1&pagesize=20 | pageindex | int | 否（默认 1）| 页码 | | pagesize | int | 否（默认 20）| 每页条数 | -### 4.5 内容字段说明 +### 4.7 内容字段说明 | 字段 | 说明 | |------|------| @@ -403,7 +443,27 @@ curl -X GET "http://58.220.83.58:8084/openapi/partner/media/list?catalogid=472&p -H "sign: A6EBB96858ED2FAD864CB39568E3EABB" ``` -### 7.6 搜索 +### 7.6 全量内容列表 + +```bash +curl -X GET "http://58.220.83.58:8084/openapi/partner/media/list-all?parentCatalogid=471" \ + -H "appKey: 你的appKey" \ + -H "timestamp: 1784809605695" \ + -H "nonce: 1784809605695aaf094ef" \ + -H "sign: A6EBB96858ED2FAD864CB39568E3EABB" +``` + +### 7.7 分集列表 + +```bash +curl -X GET "http://58.220.83.58:8084/openapi/partner/media/episodes?contentcode=23010012026061709581101832&pageindex=1&pagesize=20" \ + -H "appKey: 你的appKey" \ + -H "timestamp: 1784809605695" \ + -H "nonce: 1784809605695aaf094ef" \ + -H "sign: A6EBB96858ED2FAD864CB39568E3EABB" +``` + +### 7.8 搜索 ```bash curl -X GET "http://58.220.83.58:8084/openapi/partner/media/search?keyword=镖人&pageindex=1&pagesize=20" \ @@ -413,7 +473,7 @@ curl -X GET "http://58.220.83.58:8084/openapi/partner/media/search?keyword=镖 -H "sign: A6EBB96858ED2FAD864CB39568E3EABB" ``` -### 7.7 签名生成示例（bash） +### 7.9 签名生成示例（bash） ```bash APP_KEY="你的appKey"