# 新增账号-小说授权
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:addBookAuth
增加账号-小说的授权关系数据,主授权账号使用可一次调用新增多条授权关系(上限20条)
- 同appid每天限额调用1000000次
- 同appid每分钟限额调用100次,即2000条授权关系(建议控制好每分钟调用量,调用过猛被拦截的调用量也会消耗每日调用量的额度, 日限额耗完当日就会无法调用)
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/book/addbookauth?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:169
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| books | objarray | 是 | books |
# Body.books(Array) Object Payload
books
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| book_id | string | 是 | 作品id |
| grantee_appid | string | 是 | 被授权账号appid |
| expire_time | number | 是 | 授权到期时间unix时间戳,单位秒,按CST时区 可支持设置的最大值: 2147483646 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码。 因为新增授权可以一次增加多条授权关系,所以返回数据里 errcode 会有内外两个字段,外层 errcode 表示本次调用整体成功/失败,内层 errcode 表示每条授权关系是成功/失败。 具体可以看返回数据的示例 |
| results | objarray | results |
# Res.results(Array) Object Payload
results
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 内层errcode,表示每条授权关系是成功/失败 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"books": [
{
"book_id": "A1Hcfuuv",
"expire_time": 1704970161,
"grantee_appid": "wx002"
},
{
"book_id": "KqNdTu",
"expire_time": 1705460123,
"grantee_appid": "wx003"
}
]
}
返回示例
{
"errcode": 0, //外层errcode, 表示本次调用整体成功/失败
"results": [
{
"errcode": 0 //内层errcode,表示每条授权关系是成功/失败
}
]
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| -1 | 系统失败 |
| 0 | 成功 |
| 10140001 | 无效参数 |
| 10140002 | 请使用 utf-8 编码 |
| 10140003 | 无效的作品名 |
| 10140004 | 无效的作品简介 |
| 10140005 | 无效的封面图 |
| 10140006 | 无效的作者 |
| 10140007 | 无效的作品类型 |
| 10140008 | 无效的完结状态 |
| 10140009 | 无效的上传场景 |
| 10140010 | 无效的章节下标列表,请检查是否有重复或未覆盖所有章节 |
| 10140011 | 无效的章节ID列表,请检查是否有重复、不属于该作品的章节ID或未覆盖所有章节 |
| 10140012 | 无效的分卷列表,请检查分卷标题是否规范,区间是否存在交集或未覆盖所有章节 |
| 10140013 | 缺少章节信息 |
| 10140014 | 章节信息过多 |
| 10140015 | 缺少作品ID |
| 10140016 | 作品ID过多 |
| 10140017 | 无效的分页最大结果数 |
| 10140018 | 无效的章节标题 |
| 10140019 | 无效的章节内容 |
| 10140020 | 无效的排序操作 |
| 10140021 | 无效的章节排序方式 |
| 10140022 | 缺少章节seq |
| 10140023 | 请求参数中存在重复的提供方主键 |
| 10140024 | 无效的提供方主键 |
| 10140025 | 无效的优先级 |
| 10140026 | 无效的自定义信息 |
| 10141001 | 找不到对应信息 |
| 10141002 | 不允许操作 |
| 10141003 | 作品正在审核中 |
| 10141004 | 添加审核信息失败 |
| 10141005 | 太多检查不通过项 |
| 10141006 | 作品未审核通过,无法发布 |
| 10141007 | 作品缺少章节 |
| 10141008 | 作品分卷信息需要更新 |
| 10141009 | 提供方主键冲突 |
| 10141010 | 该接口与当前作品的章节排序方式不兼容,如需调用请先修改章节排序方式 |
| 10145001 | 操作结果为空 |
| 10145002 | 调用系统失败 |
| 10145003 | 缺少入参 |
| 10145004 | 授权作品ID无效 |
| 10145005 | 授权者不是小说类目 |
| 10145006 | 被授权者不是小说类目 |
| 10145007 | 过期的时间信息/或者授权的时间异常 |
| 10145008 | 一次提交授权的作品太多或者太少(count = 0 or count > 20) |
| 10145009 | 一次查询授权列表拉取的count太多(count > 100) |
| 10145010 | 添加的授权记录有部分失败 |
| 10145011 | appid无效 |
| 10145012 | 授权者和被授权者不能相同 |
# 7. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。