# 小说作品管理接口 小程序在申请【文娱-网络小说】类目通过后，会自动开通以下 API 调用权限以及阅读器插件调用权限。 ## 一、作品管理 每个作品均有编辑版、发布版两个版本。创建作品、编辑作品、上传章节、批量上传章节、删除章节只会更新编辑版的作品信息。作品信息编辑后需要重新提审，并且仅当所有信息审核通过后，才会更新作品的发布版信息。 阅读器插件只能获取到发布版的作品信息。 | 接口名称 | 请求路径 | 描述 | | --- | --- | --- | | [创建作品](/miniprogram/dev/server/API/novel/business/api_createbook.md) | /wxa/book/createbook | 该接口用于创建作品（小说） | | [编辑作品](/miniprogram/dev/server/API/novel/business/api_updatebook.md) | /wxa/book/updatebook | 该接口用于编辑作品编辑版的基础信息、章节顺序、分卷信息，不直接影响发布版，需要提审通过后才会更新发布版 | | [删除作品](/miniprogram/dev/server/API/novel/business/api_deletebook.md) | /wxa/book/deletebook | 该接口用于删除作品，同时作用于编辑版和发布版 | | [获取作品列表](/miniprogram/dev/server/API/novel/business/api_listbook.md) | /wxa/book/listbook | 该接口用于获取所有作品列表，分为发布版列表和编辑版列表 | | [获取作品信息](/miniprogram/dev/server/API/novel/business/api_getbook.md) | /wxa/book/getbook | 该接口用于获取作品详细信息，同获取作品列表，这里也会区分发布版和编辑版 | | [上传章节](/miniprogram/dev/server/API/novel/business/api_createchapter.md) | /wxa/book/createchapter | 该接口用于上传章节到作品编辑版信息里，不直接影响发布版，需要提审通过后才会更新发布版 | | [批量上传章节](/miniprogram/dev/server/API/novel/business/api_batchcreatechapter.md) | /wxa/book/batchcreatechapter | 该接口用于批量上传章节到作品编辑版信息里，不直接影响发布版，需要提审通过后才会更新发布版 | | [删除章节](/miniprogram/dev/server/API/novel/business/api_deletechapter.md) | /wxa/book/deletechapter | 该接口用于删除作品编辑版里的章节，不直接影响发布版，需要提审通过后才会更新发布版 | | [替换章节](/miniprogram/dev/server/API/novel/business/api_replacechapter.md) | /wxa/book/replacechapter | 该接口用于替换作品编辑版里的已有章节内容，不直接影响发布版，需要提审通过后才会更新发布版 | | [获取章节列表](/miniprogram/dev/server/API/novel/business/api_listchapter.md) | /wxa/book/listchapter | 该接口用于获取章节信息 | | [获取章节信息](/miniprogram/dev/server/API/novel/business/api_getchapter.md) | /wxa/book/getchapter | 该接口用于获取章节信息 | | [调整章节顺序](/miniprogram/dev/server/API/novel/business/api_reorderchapter.md) | /wxa/book/reorderchapter | 该接口用于调整作品编辑版信息中的章节顺序，不直接影响发布版，需要提审通过后才会更新发布版 | | [调整章节相对顺序](/miniprogram/dev/server/API/novel/business/api_updatechapterseq.md) | /wxa/book/updatechapterseq | 该接口用于调整作品编辑版信息中的章节顺序，不直接影响发布版，需要提审通过后才会更新发布版 | | [作品提审](/miniprogram/dev/server/API/novel/business/api_auditbook.md) | /wxa/book/auditbook | 作品提交审核 | ## 二、小说授权 账号-小说授权是由主授权者账号（AppID）-> 作品 ID -> 被授权者账号（AppID）三维度所构建的数据关系，API 提供对此关系数据进行增，删，改，查的能力。 | 接口名称 | 请求路径 | 描述 | | --- | --- | --- | | [新增账号-小说授权](/miniprogram/dev/server/API/novel/auth/api_addbookauth.md) | /wxa/book/addbookauth | 增加账号-小说的授权关系数据，主授权账号使用可一次调用新增多条授权关系（上限 20 条） | | [查看主授权关系列表（查看被授权关系列表）](/miniprogram/dev/server/API/novel/auth/api_querybookauth.md) | /wxa/book/querybookauth | 查看账号的小说授权关系列表，主授权账号使用 | | [删除指定的授权关系](/miniprogram/dev/server/API/novel/auth/api_delbookauth.md) | /wxa/book/delbookauth | 删除账号的小说授权关系，主授权账号使用 | ## 三、账号授权 账号授权是由主授权者账号（AppID） -> 被授权者账号（AppID）所构建的数据关系，API 提供对此关系数据进行增，删，改，查的能力。授权后，可将主授权账号的小说批量授权给被授权账号。 以下接口只维护账号级别授权信息，没有与小说级别授权信息整合。账号对小说的真实授权关系，取决于两种授权关系中的过期时间较晚的那一个。 | 接口名称 | 请求路径 | 描述 | | --- | --- | --- | | [新增账号-账号授权](/miniprogram/dev/server/API/novel/auth/api_addbookauthbyappid.md) | /wxa/book/addbookauthbyappid | 增加账号-账号的授权关系数据，主授权账号可一次调用新增多条授权关系（上限 20 条） | | [查看账号主授权关系列表](/miniprogram/dev/server/API/novel/auth/api_querybookauthv2.md) | /wxa/book/querybookauthv2 | 此接口可用于查看账号的授权关系列表，也可以看账号被授权关系列表 | | [删除指定的账号授权关系](/miniprogram/dev/server/API/novel/auth/api_delbookauthbyappid.md) | /wxa/book/delbookauthbyappid | 删除账号维度授权关系，主授权账号使用 | ## 四、事件通知 如需监听作品审核状态事件，可阅读本章内容。具体接入方式可以参考公众平台的消息推送： 如果开发者是小程序商家，请移步：[消息推送|微信开放文档](/miniprogram/dev/framework/server-ability/message-push.md) 如果开发者是服务商第三方平台，请移步：[创建与配置第三方平台准备工作|微信开放文档](/doc/oplatform/Third-party_Platforms/2.0/operation/thirdparty/prepare.md#_6%E3%80%81%E6%B6%88%E6%81%AF%E4%B8%8E%E4%BA%8B%E4%BB%B6%E6%8E%A5%E6%94%B6%E9%85%8D%E7%BD%AE) 第三方平台需新增小说阅读器管理权限集 169 并重新授权。 ### 审核状态事件 #### 请求参数 | 属性 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | book_id | string | 是 | 作品 ID | | audit_detail | BookAuditDetail | 是 | 作品审核结果。每一章的审核结果可通过「获取章节列表」查询。 | **BookAuditDetail** | 属性 | 类型 | 说明 | | --- | --- | --- | | status | number | 2：审核不通过，3：审核通过 | | create_time | number | 提审时间戳 | | audit_time | number | 审核时间戳 | ```xml gh_abcdefg oABCD 12344555555 event secbook_audit_event A1b2C3d4 3 168625255 168626255 ``` ### 小说下架事件 当作品或章节被下架时，会通过事件通知推送给开发者。 #### 请求参数 | 属性 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | book_id | string | 是 | 作品 ID | | book_title | string | 是 | 作品标题 | | chapter_id | string | 否 | 章节 ID（章节下架时有值） | | chapter_title | string | 否 | 章节标题（章节下架时有值） | | ban_status | number | 是 | 下架状态。0：正常，1：下架 | | time | number | 是 | 操作时间戳 | ```xml gh_abcdefg oABCD 12344555555 event book_ban_status_change A1b2C3d4 作品标题 1 ``` ## 五、预览设置 当用户尚未付费解锁某章节时，会默认进入章节预览模式，默认预览 150 个字。如果有自定义需求则可通过预览设置接口进行设置。 | 接口名称 | 请求路径 | 描述 | | --- | --- | --- | | [预览设置修改](/miniprogram/dev/server/API/novel/preview/api_setpreviewsetting.md) | /wxa/business/novelreader/setpreviewsetting | 设置书本章节预览字数 | | [预览设置获取](/miniprogram/dev/server/API/novel/preview/api_getpreviewsetting.md) | /wxa/business/novelreader/getpreviewsetting | 获取书本章节预览字数设置 | ## 六、运营能力 | 接口名称 | 请求路径 | 描述 | | --- | --- | --- | | [读后推荐](/miniprogram/dev/server/API/novel/other/api_novelreadersetrecmdnovel.md) | /wxa/business/novelreader/setrecmdnovel | 阅读器插件支持在阅读后推荐其他小说,开发者需要主动设置想要推荐的小说 | ## 七、更新记录 ### 2025年12月2日 1. 新增账号维度的小说授权接口，支持授权方批量将小说授权给其他账号。 ### 2024年12月18日 1. 支持删除作品 ### 2024年11月27日 1. 支持读后推荐功能 ### 2024年05月21日 1. 作品/章节支持传入自定义信息 ### 2024年05月09日 1. 获取作品列表新增 last_id 分页方式 ### 2024年04月18日 1. 支持第三方平台，权限集 ID 169 ### 2024年04月12日 1. 支持传入作品/章节提供方主键去重 2. 支持切换作品章节排序方式，新增 seq 递增排序 3. 新增替换章节、调整章节相对顺序接口 ### 2024年03月12日 1. 支持审核状态事件通知 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（2条） 2026 年 07 月 17 日删除了多余的内容 2026 年 05 月 18 日小说新增下架事件通知