payment-package-links.md 2.0 KB

付费链接与 Token 流程

当前开通链接

技能包在需要开通或充值时,会生成面向用户的链接:

https://app.fmode.cn/dev/apig-pay/?apigid=G0vmsUI44d&fun_id=voc-e-commerce

如果运行时能通过 sessionToken 解析到 Parse 用户,链接会追加 user=<objectId>,方便用户直接进入对应账号的开通/充值页面。

APIG 包信息

APIG objectId: G0vmsUI44d
APIG path: /apig/voc-e-commerce
Title: 国内电商数据中台
Service: Fmode

本文档不写具体定价。价格和套餐后续单独维护,避免客户侧文档与实际计费口径不一致。

社媒分析服务开通链接

参考账号补证(作者主页、近作、互动中位数)和视频参考详情补证,统一走「社媒分析服务」。需要开通或充值时,会生成面向用户的链接:

https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF

同样地,若运行时能通过 sessionToken 解析到 Parse 用户,链接会追加 user=<objectId>

APIG objectId: Vo3ROWEvDy
fun_id: HOkkX72PMF
Title: 社媒分析服务
Service: Fmode

对外只暴露「社媒分析服务」这一名称,不暴露任何底层供应商名。社媒分析服务未开通或余额不足时,返回 needs_recharge 并展示上面的「社媒分析服务充值」链接,保持 errors=[]

友好状态

场景 状态 用户侧处理
未提供 token needs_token 展示开通/充值链接和配置下一步
401 needs_valid_token 提示用户提供有效 sessionToken
403 needs_recharge 展示开通/充值链接
正常 ok 返回报告正文和文件

这些友好状态下保持 errors=[],避免 Claude Code 把原始错误块展示给客户。

脱敏规则

任何报告、日志、CSV、JSON、Markdown 和聊天输出都不能展示:

  • Authorization
  • Bearer ...
  • sessionToken 明文
  • sk-... 模型 token 明文
  • 原始 401/403 响应体
  • 上游 stack trace