# 业务规则说明

# 付费/免费模式

说明:需提前与阅文商务同学确定本次合作是免费或付费

规则:

类型 说明 实时获取内容 API
付费合作 用户阅读付费章节需要购买,免费章节免费阅读 (付费模式)获取章节内容
免费合作 用户免费阅读 (免费模式)获取章节内容

书籍的付费章节规则:根据章节信息的返回值 chaptertype 与 vipflag 判断

付费书章节类型 条件
付费章节 chaptertype=1 且 vipflag=1
免费章节 非付费章节

# 书籍折扣信息

说明:付费合作模式下,需提前与阅文商务沟通并配置书籍折扣。

规则: 配置折扣书单,请合作方根据双方业务约定的书单重新拉书籍基本信息、书籍章节列表等(配置折扣信息,并不会有接口更新通知)。

# epub 书规则

说明: 如果合作中有 epub 格式的书籍,需要根据以下流程进行书信息与内容的获取。

epub 书获取步骤 说明
第一步:判断 epub 书 合作方获取书籍基本信息返回数据中的 file_format 字段判断是否为 epub 书。
第二步:合作方用户实时获取 epub 书籍内容 实时获取 epub 书籍文件下载地址,根据请求下载地址获取文件信息。

# 书籍更新/上架/下架规则

说明:书籍信息会发生变化,因此合作方需要获取最近更新与上架、下架的书籍 ID,然后更新/新增/删除对应的书籍信息。

书籍上架/更新流程

注意:返回值是 url 地址链接,需要重新获取 url 内容进行新增或更新。

步骤 说明
第一步:定时获取近期更新与上架的书籍 ID 列表 (建议 10 分钟 1 次)获取指定时间内更新与上架书籍 ID 列表
第二步:获取书籍最新基本信息 获取书籍基本信息,合作方替换存储信息。
第三步:获取书籍最新目录信息 获取书籍的所有章节列表,合作方替换存储信息。

书籍下架流程

步骤 说明
第一步:定时获取近期下架的书籍 ID 列表 (建议 10 分钟 1 次)获取指定时间内下架书籍 ID 列表
第二步:合作方下架书籍 请合作方下架书籍,并删除已经存储对应书籍的所有信息