diff --git a/API_DOC.md b/API_DOC.md
index 56baf69..514eecd 100644
--- a/API_DOC.md
+++ b/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`
| 路径 | 方法 | 参数 | 说明 |
diff --git a/src/main/java/io/as/modules/media/client/JetsenMediaClient.java b/src/main/java/io/as/modules/media/client/JetsenMediaClient.java
index b56ad19..b13e1ff 100644
--- a/src/main/java/io/as/modules/media/client/JetsenMediaClient.java
+++ b/src/main/java/io/as/modules/media/client/JetsenMediaClient.java
@@ -98,6 +98,22 @@ public class JetsenMediaClient {
return post("content/getcontentlist.do", biz);
}
+ /**
+ * 分集列表（通过父级 contentcode）
+ * 橘视厅 getcontentlist.do 传 contentcode 参数时返回该内容的分集列表（电视剧各集）。
+ * @param contentcode 父级内容编码（电视剧的 contentcode）
+ * @param pageindex 页码，从 1 开始
+ * @param pagesize 每页条数
+ */
+ public JSONObject getEpisodes(String contentcode, int pageindex, int pagesize) {
+ Map biz = new HashMap<>();
+ biz.put("contentcode", contentcode);
+ biz.put("orderinfo", "1");
+ biz.put("pageindex", String.valueOf(pageindex));
+ biz.put("pagesize", String.valueOf(pagesize));
+ return post("content/getcontentlist.do", biz);
+ }
+
/**
* 搜索
* @param searchvalue 关键字
diff --git a/src/main/java/io/as/modules/openapi/controller/OpenApiMediaController.java b/src/main/java/io/as/modules/openapi/controller/OpenApiMediaController.java
index 50c52eb..7d6bb61 100644
--- a/src/main/java/io/as/modules/openapi/controller/OpenApiMediaController.java
+++ b/src/main/java/io/as/modules/openapi/controller/OpenApiMediaController.java
@@ -293,6 +293,39 @@ public class OpenApiMediaController {
return ids;
}
+ /**
+ * 分集列表（通过父级 contentcode）
+ * 传入电视剧的 contentcode，返回其下各分集列表，分集的 contentcode 可作为 programCode 传入 SDK 获取播放地址。
+ * 三级授权：CONTENT(校验contentcode在授权范围内) > CATALOG/FULL(直接返回)
+ */
+ @ApiOperation("分集列表（通过父级contentcode）")
+ @GetMapping("/episodes")
+ public R episodes(@RequestParam String contentcode,
+ @RequestParam(defaultValue = "1") int pageindex,
+ @RequestParam(defaultValue = "20") int pagesize,
+ HttpServletRequest req) {
+ long start = System.currentTimeMillis();
+ String partnerId = partnerIdFrom(req);
+ ContentPackageEntity pkg = contentPackageService.getByPartnerId(partnerId);
+ Set contentCodes = parseContentCodes(pkg);
+
+ // CONTENT级别：校验 contentcode 在授权范围内
+ if (contentCodes != null && !contentCodes.contains(contentcode)) {
+ logCall(req, "/episodes", "GET", 400, start);
+ return R.error("contentcode不在授权范围内");
+ }
+
+ JSONObject resp = jetsenMediaClient.getEpisodes(contentcode, pageindex, pagesize);
+ Map data = new HashMap<>();
+ data.put("list", extractList(resp));
+ data.put("totalCount", resp.getIntValue("sizetotal"));
+ data.put("currPage", pageindex);
+ data.put("pageSize", pagesize);
+ data.put("totalPage", resp.getIntValue("pagetotal"));
+ logCall(req, "/episodes", "GET", 0, start);
+ return R.dataSuccess(data);
+ }
+
/** 搜索（按授权过滤） */
@ApiOperation("搜索")
@GetMapping("/search")