Skip to content

关于 授权

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

授权是授予应用权限的过程。当商家安装应用时同意授权给应用相应 Genstore 平台的权限范围,平台将会颁发相应权限范围的访问令牌,应用将使用该访问令牌与 Genstore 平台交互。

核心功能

  • 查询授权范围:提供查询应用当前权限范围的接口。

应用场景

  • 权限范围更新:应用可通过查询授权范围接口获取当前权限,在发现新增访问范围时引导商家进行授权更新。

接口

EVENT app/authorizationCodeGranted: 授权码授予

授权范围 对象

授权应用的访问范围。

属性

accessScopesstring
访问令牌具有的权限列表。
bash
{
  "accessScopes": "[read_orders,write_orders]"
}

EVENT 授权码授予

店铺初始化进行预安装应用时,会对应用授予授权码。

访问范围

需要以下任意访问权限: write_apps read_apps

消息

EVENT app/authorizationCodeGranted 

消息数据

authCodeobject
授权码信息。
- 收起属性
clientIdstring
应用的客户端 ID。
shopIdnumber
当前商店的唯一标识符。
codestring
用来获取token的授权码。
json
{
  "authCode": {
    "clientId": "58DAED6AEC7AA1C2C8DFD719E8E06E3A",
    "code": "e4141dwadwae1312",
    "shopId": "4022054969604"
  }
}