# API 接口
# 获取漫剧列表
简要描述:该API用于获取漫剧列表,合作方可定期(每日一次)拉取接口与本地对比,对漫剧做上下架操作
请求方式:GET(HTTPS)
请求地址:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=list
请求参数:(查看通用请求参数)
| 请求参数 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| pageNo | 否 | int | 页码,默认为1 |
| pageSize | 否 | int | 分页大小,最大100 |
返回字段:(查看通用返回字段)
| 字段名称 | 字段类型 | 说明 | 业务说明 |
|---|---|---|---|
| resultData | []string | 漫剧ID列表 | 作品唯一标识 |
| totalCount | int | 总数 | 总数 |
请求示例:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=list&appKey=xxxxxxx&appToken=xxxxxx
返回示例:
{
"returnCode": 0,
"returnMsg": "成功",
"result": {
"resultData": [
"33699840503351401"
],
"totalCount": 1
}
}
# 获取漫剧基本信息
简要描述:该API用于获取漫剧信息
请求方式:GET(HTTPS)
请求地址:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=info
请求参数:(查看通用请求参数)
| 请求参数 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| vdid | 是 | string | 漫剧ID |
返回字段:(查看通用返回字段)
| 字段名称 | 字段类型 | 说明 | 业务说明 |
|---|---|---|---|
| vdid | string | 漫剧ID | 作品唯一标识 |
| name | string | 名称 | 漫剧名称 |
| intro | string | 简介 | 漫剧简介 |
| categoryName | string | 分类 | 漫剧分类名 |
| coverUrl | string | 封面图 | 封面的URL地址,需转存图片,不可直接将此地址提供给用户 |
| createTime | int | 创建时间 | 时间戳(秒) |
| updateTime | int | 更新时间 | 时间戳(秒) |
| chapterCount | int | 集数 | 漫剧总集数 |
| totalSize | float | 体积 | 视频总体积MB |
| scheduleStatus | int | 连载状态 | 1连载中、2完结 |
| chargeType | int | 收费方式 | 1免费、2整部、3按集 |
| startChargeSort | int | 开始收费的序号 | 集的序号sort>=此字段收费 |
| singleMoney | int | 单集价格 | 按集购买的单价(分) |
| totalMoney | int | 整部总价 | 整部购买的总价(分) |
| sexAttr | int | 性别取向 | 1男频、2女频 |
| dramaType | string | 漫剧类型 | 动画短剧、拟真短剧、简易动画、拟真解说 |
| 以下字段仅用于备案提审,不可在用户端展示 | |||
| producer | string | 制片人 | 多个制片人以英文逗号分隔 |
| director | string | 导演 | 多个导演以英文逗号分隔 |
| writers | string | 编剧 | 多个编剧以英文逗号分隔 |
| actors | string | 主演 | 多个主演英文逗号分隔 |
| copyright | string | 版权方 | 版权方(制作机构) |
| investment | string | 投资额 | 投资额(万) |
请求示例:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=info&vdid=33699840503351401&appKey=xxxxxx&appToken=xxxxx
返回示例:
{
"returnCode": 0,
"returnMsg": "成功",
"result": {
"vdid": "33699840503351401",
"name": "我的道观通历史",
"intro": "爷爷走后,我便成了这天灵山唯一的小道士,陪着我的只有道观后成群的坟堆,而今日道观门前竟然来了二十年来第一位客人\n",
"categoryName": "历史",
"coverUrl": "https://openbookcover.yuewen.com/qdbimg/349573/a_33699840503351401/300",
"createTime": 1757041231,
"updateTime": 1763522764,
"chapterCount": 20,
"totalSize": 5648.57,
"scheduleStatus": 2,
"chargeType": 1,
"startChargeSort": 0,
"singleMoney": 0,
"totalMoney": 0,
"sexAttr": 1,
"producer": "阅文漫剧",
"director": "阅文漫剧",
"actors": "阅文漫剧",
"writers": "阅文漫剧",
"copyright": "北京红袖添香科技发展有限公司",
"investment": "3.0",
"dramaType": "简易动画"
}
}
# 分页获取集列表
简要描述:该API用于分页获取指定漫剧的集列表
请求方式:GET(HTTPS)
请求地址:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=chapterList
请求参数:(查看通用请求参数)
| 请求参数 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| vdid | 是 | string | 漫剧ID |
| pageNo | 否 | int | 页码,默认为1 |
| pageSize | 否 | int | 分页大小,最大20 |
返回字段:(查看通用返回字段)
| 字段名称 | 字段类型 | 说明 | 业务说明 |
|---|---|---|---|
| vcid | string | 集ID | 集的唯一标识 |
| name | string | 名称 | 集的名称 |
| index | int | 编号 | 集的编号,即第n集 |
| sort | int | 序号 | 集的序号,用于判断收费 |
| duration | int | 时长 | 时长(秒) |
| size | float | 体积 | 视频体积(MB) |
| createTime | int | 创建时间 | 时间戳(秒) |
| updateTime | int | 更新时间 | 时间戳(秒) |
| width | int | 宽度 | 视频宽度(像素) |
| height | int | 高度 | 视频高度(像素) |
| frameRate | int | 帧率 | 视频帧率(fps) |
| bitRate | int | 码率 | 视频码率(bps) |
| videoFormat | string | 格式 | 视频格式 |
请求示例:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=chapterList&vdid=33245321707201001&appKey=xxxxxx&appToken=xxxxxx&pageNo=1&pageSize=10
返回示例:
{
"returnCode": 0,
"returnMsg": "成功",
"result": {
"resultData": [
{
"vcid": "90462331909233215",
"name": "第1集",
"index": 1,
"sort": 1000,
"duration": 351,
"size": 634.107,
"createTime": 1757041238,
"updateTime": 1757041385,
"width": 1920,
"height": 1080,
"frameRate": 30,
"bitRate": 15121873,
"videoFormat": "mp4"
},
{
"vcid": "90462331842131460",
"name": "第2集",
"index": 2,
"sort": 2000,
"duration": 313,
"size": 562.475,
"createTime": 1757041238,
"updateTime": 1757041353,
"width": 1920,
"height": 1080,
"frameRate": 30,
"bitRate": 15032040,
"videoFormat": "mp4"
}
],
"totalCount": 20
}
}
# 获取单集下载链接
简要描述:该API用于获取单集的下载链接,有效期1小时,合作方需转存视频,禁止将此链接直接提供给用户
请求方式:GET(HTTPS)
请求地址:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=content
请求参数:(查看通用请求参数)
| 请求参数 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| vdid | 是 | string | 漫剧ID |
| vcid | 是 | string | 集ID |
返回字段:(查看通用返回字段)
| 字段名称 | 字段类型 | 说明 | 业务说明 |
|---|---|---|---|
| url | string | 下载地址 | 下载地址 |
| timeout | int | 有效期 | 链接失效时间戳(秒) |
请求示例:
https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama&action=content&vdid=33245321707201001&vcid=89242226995035272&appKey=xxxxxx&appToken=xxxxx
返回示例:
{
"result": {
"timeout": 1763005840,
"url": "https://xxx.mp4"
},
"returnCode": 0,
"returnMsg": "成功"
}
# 更新记录
| 日期 | 描述 |
|---|---|
| 2026-07-20 | 漫剧信息-增加漫剧类型字段 |
| 2025-12-16 | 增加漫剧列表接口,漫剧信息-增加备案提审相关字段 |
| 2025-12-11 | 集信息-增加视频属性相关字段 |
| 2025-12-04 | 漫剧信息-增加性别取向字段 |
| 2025-11-24 | 漫剧信息-增加付费相关字段 |
| 2025-11-13 | 初版 |
← 接口规范