Skip to main content
App 市场(/marketplace/apps)收录第三方开发者构建的外部应用。它们通过袋袋的开放 API 接入平台,用你的袋袋身份和积分提供服务。

App 不是专家

这是最容易混淆的一点:
点「开始使用」会在新标签页打开该应用自己的主页——不是在袋袋里打开一个内嵌应用。如果这个 App 没有填主页地址,按钮会提示无法跳转。市场页面上没有安装步骤,也没有「已安装 App」列表或撤销授权的入口。授权发生在你到那个应用站点上用袋袋账号登录时。

浏览

详情页展示功能介绍、开发者信息与使用量(调用次数、使用人数)。这两个计数在使用发生时异步累加,可能有短暂延迟。

积分怎么扣

App 的计费不是「买断」或「订阅」,而是按开发者定义的事件计次
1

开发者定义事件

每个 App 声明若干计费事件(比如「一次翻译」「一次导出」),每个事件有固定的积分单价。
2

你在应用里触发操作

应用调用袋袋的事件上报接口,带上事件名与幂等键。
3

按单价扣积分

从你的个人积分账户扣除该事件的单价。同一个幂等键重复上报不会重复扣费,返回上一次的结果。

每日消费上限

每个「App × 用户」组合有独立的每日积分上限,默认 500 积分/天。超过后该 App 当天的计费请求返回 daily_cap_exceeded(HTTP 429),响应里会带上今日已花与限额。上限每天自动重置。
这是保护性设计:一个行为异常的第三方应用最多只能花掉你 500 积分,而不是整个余额。上限可按用户单独调整。

常见计费错误

这些错误出现在应用侧,通常表现为该应用提示「操作失败」。前三种都不是你的账户问题。

上架与审核(创作者视角)

App 上架走与专家一致的审核双行机制:
  • 提交需要已通过认证的创作者身份,否则 403
  • 已上线的 App 提交新版本时,老版本继续在线,新内容进待审队列
  • 有待审提交时禁止再次编辑或提交,返回 409
  • 审核通过:新内容写回并生成版本快照;审核拒绝:已上线的保持在线,首次发布的置为未通过
  • 创作者可撤回待审提交,也可从「未通过」重新编辑再提交

失败与对策

开发者视角

Platform 控制台

管理 App、API Key 与调用日志

Events API

事件上报与计次计费接入

相关页面

专家市场

在袋袋里直接对话的 AI 专家

技能商店

可安装的方法文档