# 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 初版