# 接口规范
# 调用方式
请求方式：GET
请求地址：
| 接入类型 | 请求地址 |
|---|---|
| 接入点 | https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComic |
请求头：
| 说明 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | application/x-www-form-urlencoded |
请求和响应的字符集编码均为 UTF-8
# 请求通用参数
通用入参：以下参数在所有接口调用均需传入，各接口不再重复说明。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appKey | string | 是 | 接入方唯一标识，在阅文开放平台获取的 appKey |
| appToken | int | 是 | 请求token, 参考生成规则 |
# 通用返回字段
通用出参：以下参数在所有接口返回值中均存在，各接口不再重复说明。
| 参数 | 类型 | 说明 | 业务说明 |
|---|---|---|---|
| returnCode | int | 返回码 | 业务状态码，0为成功，其它失败 |
| returnMsg | string | 返回信息 | 业务状态码对应的信息 |
| result | object | 返回内容 | 各接口返回对象 |
# appToken 生成规则
为了确保接口调用过程中的安全性，所有接口都需要携带 appToken，接口会根据请求参数，对签名进行验证，并拒绝签名不合法的请求，appToken 生成如下：
| 步骤 | 说明 |
|---|---|
| 1 | 取 appKey 的最后四位，后面加上 yyyyMMdd 格式的当日日期，组成字符串 |
| 2 | 用步骤 1 获取的字符串生成 MD5 值（32 位小写） |
| 3 | 取生成的 MD5 值的前 12 位，即为 appToken |
# 漫画排序规则
- 漫画先按话排序，话内按页排序
- 话按huasort从小到大排序
- 页排序区分页漫和条漫（见/comic/base 的type）：页漫按pagesort排序；条漫的页存在多个页对应一个原页的情况，需先按原页sourcepagesort排序，再按pagesort排序。例：a ( pagesort=1), b (pagesort=2)对应原页sourcepagesort=1，c (pagesort=1), d (pagesort=2)对应原页sourcepagesort=2，最终排序为：a, b, c, d。
API 接口 →