# 落地内容 API

本章内容适用于落地文学API合作

# 获取书籍章节内容

简要描述:该 API 用于获取指定章节内容。

请求方式:GET(HTTPS)

请求地址

https://cpapi-i.yuewen.com/api/v1/chapter/content

请求参数:查看通用请求参数

请求参数 是否必须 类型 说明
cbid string 书籍ID
ccid string 章节ID

返回字段:(查看通用返回字段

字段名称 字段类型 说明 业务说明
ccid string 章号 作品章节的唯一标识
cbid string 书籍ID 书籍唯一ID
content string 章节内容 作品的正文

如果在正文内容中包含以下字符,请您自行转义字符:

字符 转义符号 字符名称
& & & 符号
&lt; < 小于号
&gt; > 大于号
&quot; " 双引号
&apos; ' 单引号

正文内容中会包含emoji表情,以unicode编码方式输出,例如’\ud83d\ude04’,请您自行转义字符,常见方法:

平台 方法描述
HTML 1. 使用 CSS:通过 CSS 定义 emoji 字体,确保在 HTML 中直接使用 emoji 字符时能够正确显示。
2. 使用第三方库:如 twemoji,这是 Twitter 开源的项目,可通过 script 标签引入 js 文件使用。twemoji.parse 函数可处理文本,将 emoji 代码转换为 img 标签。
3. 构建过程中处理:在 Webpack 构建中,通过配置 loader 或插件处理 HTML 文件中的 emoji。可编写自定义 loader 识别 HTML 文件中的 emoji 代码,并转换为 img 标签或 unicode 字符。
Android 1. 使用 Android 官方库支持 emoji 查看详情
2. 使用第三方库,如 Emoji 查看详情
iOS 1. 使用系统默认的 Emoji 字体。

请求示例:

https://cpapi-i.yuewen.com/api/v1/chapter/content?cbid=1&ccid=1&appflag=xxx&timestamp=xxx&sign=XXX

返回示例:

{
  "code": 0,
  "message": "成功",
  "data": {
    "cbid": "3589892203774001",
    "ccid": "9636543557189937",
    "content": "入夜,罗伦市安静得如同一个熟睡中的少年,宽敞的街道空无一人,零星的路灯照不到的地方全是伸手不见五指的漆黑,寒风吹过,令人瑟瑟发抖,落叶被唰的一声卷起,从博物馆门前扫过。\r\n"
  }
}

# 获取 epub 书籍文件下载地址

简要描述: 该 API 用于 epub 格式的书籍获取书内容信息,属于非通用接口,使用前需要与阅文方沟通开启权限。参考 epub 规则

请求方式:GET(HTTPS)

请求地址

https://cpapi-i.yuewen.com/api/v1/epub/url

请求参数:查看通用请求参数

请求参数 是否必须 类型 说明
cbid string 书籍唯一ID
fileType int 1:试读版 0:完整版

返回字段:(查看通用返回字段

字段名称 字段类型 说明 业务说明
cBID long 书籍唯一ID 书籍唯一ID
url string 下载地址 epub文件下载地址

请求示例:

https://cpapi-i.yuewen.com/api/v1/epub/url?cbid=1&fileType=1&appflag=xxx&timestamp=xxx&sign=XXX

返回示例:

{
  "code": 0,
  "message": "成功",
  "data": {
    "cBID": 1,
    "url": "https://epubservercos.yuewen.com/E073AC/3590431004458601/3590431004458601_epub.new?sign=1704959048-06bf958e24f64ddfa86ddc8d841db1dc-0-1819e89899021ab8cf13986f68ed30b0"
  }
}