# 落地内容 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 | 章节内容 | 作品的正文 |
如果在正文内容中包含以下字符,请您自行转义字符:
字符 | 转义符号 | 字符名称 |
---|---|---|
& | & | & 符号 |
< | < | 小于号 |
> | > | 大于号 |
" | " | 双引号 |
' | ' | 单引号 |
正文内容中会包含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×tamp=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×tamp=xxx&sign=XXX
返回示例:
{
"code": 0,
"message": "成功",
"data": {
"cBID": 1,
"url": "https://epubservercos.yuewen.com/E073AC/3590431004458601/3590431004458601_epub.new?sign=1704959048-06bf958e24f64ddfa86ddc8d841db1dc-0-1819e89899021ab8cf13986f68ed30b0"
}
}