商家在开放平台发现并安装第三方(或官方)应用,按门店授权数据访问权;服务商用统一凭证经 Gateway 调用,无需再抄密钥绑店。
适合谁
- 商家管理员(安装/授权/吊销)
- ISV / 服务商开发者(上架、申请权限)
- 平台运营(上架与权限审核)
核心能力
- 应用市场浏览已上架公开应用
- 按门店授权 + Scope 权限清单确认
- 私有应用仅体系内;公开应用须审核上架
- OAuth 授权码对接(含首方云)
- 免费安装或年付/永久(余额支付);下架不影响已购未到期授权
使用流程
- 1服务商创建应用(默认私有),申请 Scope 并填写对外介绍/回调
- 2权限审核通过后,开发者「申请转公开上架」;运营审核通过后变为公开并进入市场
- 3商家在应用市场安装:免费直接授权;付费选择年付/永久并用余额支付
- 4服务商用 Auth/token 换 access_token,经 Gateway/invoke + 已授权 qym_id 调业务接口
> 应用类型不可下拉自选:只能私有起步,经申请与审核流转为公开;已公开仅能下架后再申请上架。
业务流转
flowchart TB Dev[服务商应用] -->|上架审核| Market[应用市场] Market -->|免费或付费安装| Grant[授权记录] Client[服务商系统] -->|OAuth换票| Token[access_token] Token --> Gateway[Gateway_invoke] Gateway -->|校验授权与Scope| Grant Grant -->|事件推送| Client
界面线框
flowchart TB subgraph openplatform [开放平台] Apps[我的应用] Market[应用市场] MyAuth[我的授权] Audit[应用审核] end Market --> AuthPage[授权确认页] AuthPage --> MyAuth
示意图表
pie title 授权体系构成示意 "应用凭证" : 20 "门店授权" : 35 "Scope权限" : 25 "安装计费" : 20
应用市场发现与安装公开应用
能力市场购买平台菜单权限组
开放能力开发者凭证与 Gateway 调用
示意图,非真实经营数据。禁止在介绍文写具体价格数字。
后台入口
- 菜单路径: 开放平台 → 应用市场 / 我的授权 / 应用审核 / 开放应用
- 代表 url:
appsmarket/index
开通与前置
- 开放平台相关权限;商家需有可授权门店
- 公开应用须
on_shelf;私有应用仅开发者组织树内可授权 - 付费安装需账户余额充足
边界与注意
- 不等于能力市场(
appcenter)卖权限组 - 禁止 Open 接口代开登录账号;新账号走总部邀请注册链接
- .member_id` 表示开发者归属;业务门店经
- 吊销后 Open 立即拒绝;多服务商可并行授权并各自收推送
- 类型流转:新建固定私有;公开须「申请转公开 → 运营通过」;开发者不能自行改类型或降级为私有
- 下架:只挡新安装;已购未到期授权仍可调用
常见问题
问:和开放能力文档里的「开放应用」什么关系?
答:开放应用是开发者凭证宿主;本能力是商家侧市场安装与授权生命周期。
问:私有应用会出现在市场吗?
答:不会。私有仅体系内授权,无公开服务详情页。
问:创建时能直接选公开吗?
答:不能。须先以私有创建,补齐对外素材与权限审核后,再申请转公开上架。
问:付费应用下架后还能用吗?
答:已购买且未到期的授权仍可调用;新用户不能再安装。