开放能力

连接扩展 · 2026-08-13 19:10

面向对接的开放应用身份与调用能力,让商家/ISV 感知「可以对接」。

适合谁

  • ISV / 技术对接
  • 商家管理员

核心能力

  • 开放应用身份(开发者持有凭证)
  • access_token 换票 + Gateway 统一调用
  • 业务数据进出(须经门店授权)
  • 双卖点:按次 Token 调用费 + 应用安装年付/永久
  • MCP 经营分析:价格影响 / 动销 / 货架移位(scope report.read)

使用流程

  1. 1
    在「我的应用」创建私有或公开应用
  2. 2
    配置回调与申请 Scope,公开应用走市场审核
  3. 3用应用编号/密钥调用 Auth/token 换取 access_token
  4. 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 方法。

联系咨询 进入后台
返回分类