面向对接的开放应用身份与调用能力,让商家/ISV 感知「可以对接」。
适合谁
- ISV / 技术对接
- 商家管理员
核心能力
- 开放应用身份(开发者持有凭证)
- access_token 换票 + Gateway 统一调用
- 业务数据进出(须经门店授权)
- 双卖点:按次 Token 调用费 + 应用安装年付/永久
- MCP 经营分析:价格影响 / 动销 / 货架移位(scope
report.read)
使用流程
- 1在「我的应用」创建私有或公开应用
- 2配置回调与申请 Scope,公开应用走市场审核
- 3用应用编号/密钥调用 Auth/token 换取 access_token
- 4经 Gateway/invoke,按公开方法名(method)调试业务接口
业务流转
flowchart LR App[开放应用_开发者] --> Token[Auth_token换票] Token --> Gateway[Gateway_invoke] Grant[商家授权] --> Gateway Gateway --> Biz[订单/商品等业务]
界面线框
flowchart TB Apps[开放应用/我的应用] --> Token[凭证与调用额度] Apps --> Docs[开发者文档站] Docs --> OpenAPI[OpenAPI_MCP导出]
示意图表
pie title 开放能力感知示意 "应用身份" : 30 "授权边界" : 25 "Gateway调用" : 25 "Token计费" : 20
开放应用对接身份与凭证
应用市场商家安装与授权(见 open-app-market)
能力市场卖后台菜单权限组
示意图,非真实经营数据。介绍文不写具体价格数字。
后台入口
- 菜单路径: 开放平台 → 开放应用(我的应用)
- 代表 url:
apps
开通与前置
- 开放平台权限
边界与注意
- 与能力市场无关:能力市场卖
auth_group,本能力管 Open API 应用 - 与应用市场分工:本页是开发者控制台;商家发现安装见 [
open-app-market](open-app-market.md) - 调用须带 access_token;门店数据须已授权
qym_id - MCP 价格/移位分析依赖改价与移位事件表;上线前无历史事件,需执行
20260915_product_price_placement_log/20260915_open_report_mcp_api - 介绍文不展开运维 CRUD
常见问题
问:和能力市场一样吗?
答:不一样:一个卖权限组,一个做 API 应用与授权。
问:一家服务商要为每个商家建一个应用吗?
答:不要。一个应用 + 多家门店授权行。
问:旧的直连 Controller/action 还能用吗?
答:请改走 Gateway/invoke + method(公开方法名)。
问:豆包等如何拉价格与移位分析?
答:勾选 report.read / product.read,用 mcpToolsJson 导出的 qiyi.report.* / qiyi.shelf.placement.list 方法。