# 作品提审

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
book_idstring作品id

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber-错误码
errmsgstringok错误信息

# 4. 注意事项

作品可发起提审的前提条件包括:

  1. 至少有一章
  2. 若有分卷,分卷信息需要覆盖所有章节(上传、删除章节后需要重新修改分卷信息)

# 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添加的授权记录有部分失败
10145011appid无效
10145012授权者和被授权者不能相同

# 7. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。