# 接口规范
# 调用方式
请求方式:GET
请求地址:
| 接入类型 | 请求地址 |
|---|---|
| 接入点 | https://api.yuewen.com/content/cp/ServiceBus.do?service=cpComicDrama |
请求头:
| 说明 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 |
API 接口 →