# 作品提审
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:auditBook
作品提交审核。审核通过后会更新作品发布版信息。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/book/auditbook?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
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| book_id | string | 是 | 作品id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | - | 错误码 |
| errmsg | string | ok | 错误信息 |
# 4. 注意事项
作品可发起提审的前提条件包括:
- 至少有一章
- 若有分卷,分卷信息需要覆盖所有章节(上传、删除章节后需要重新修改分卷信息)
# 5. 代码示例
请求示例
{
"book_id": "A1b2C3d4"
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 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. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。