跳转到主要内容
Jiewen’blog
功能使用

Tools 集成与受限文章阅读

适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。

Tools 集成用于识别文章中的受限区域,并按服务端规则判断是否可以阅读。没有使用受限内容的站点可以不启用;文章限制本身仍需在 Tools 和文章编辑流程中维护。

配置集成

  1. 安装并启用与当前 TinyTale 集成接口兼容的 Tools 插件。

  2. 在 Tools 中配置 TinyTale 专用集成令牌 tinyTaleIntegrationToken。

  3. 在 TinyTale → 插件集成 → Tools 插件中启用集成,把同一令牌填入 integrationToken。

  4. 使用验证码扫码交付时,配置有效的扫码图片地址,并确认相关域名可在小程序访问。

  5. 选择一篇测试文章,分别以游客、普通账号和满足条件的账号验证限制。

专用集成令牌只在服务端配置,不放入小程序环境文件、文章正文或公开截图。它与旧网页使用的 authToken 不是同一个配置项。

当前交互能力

阅读条件

小程序处理方式

登录后阅读

提示登录后重新检查权限

密码阅读

登录后提交阅读密码,由服务端验证

验证码阅读

按可用的扫码说明获取验证码,登录后验证

评论后阅读

提交评论后重新检查;是否满足条件仍由服务端判断

付费阅读

提示通过原文网站完成支付,再返回重新加载

验证码扫码入口依赖可用的扫码配置。后台虽然保留广告验证码类型和广告位字段,当前广告验证码接口返回 AD_VERIFICATION_UNAVAILABLE,不能将其作为已支持的广告解锁能力宣传或上线。

小程序没有在此流程内完成原生支付。原文支付后仍需满足对应账号和文章策略;如果返回后依旧受限,核对网站与小程序使用的账号、订单授权和服务端状态,不要假定网页 Cookie 会自动传给小程序。

匿名评论后的阅读凭证

允许匿名评论的文章,客户端提交主评论后会尝试申请与该文章关联的匿名阅读凭证。凭证签发与最终阅读许可仍受服务端校验和文章策略约束。

出现“评论成功,内容解锁暂未生效”时,说明评论与阅读凭证是两个独立结果。先确认评论状态,再重新加载;不要仅为了获取凭证重复发表评论。回复评论不等同于这一步主评论凭证申请。

配置失败与停用

令牌不匹配、Tools 不可用或返回数据不符合要求时,受限内容会保持不可读,不会自动降级公开全文。这有助于避免配置故障时意外展示受限部分。

如果准备停用集成,先在源文章和 Tools 中梳理已有策略,确认哪些内容应公开、迁移或继续受限,再停用。仅关闭集成开关不能当作取消文章限制的方法。

故障排查时记录文章名、阅读条件、当前登录状态和接口错误码,隐藏令牌、密码、验证码和个人信息。

文档导航