简体中文

English

简体中文

English

显示模式

关于 授权 ​

访问范围

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

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

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

核心功能

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

应用场景

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

接口

DELETE /api/202412/oauth2/uninstall: 卸载应用

GET /api/202412/oauth2/access_scopes: 获取访问范围

授权范围 对象 ​

授权应用的访问范围。

属性 ​

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

DELETE 卸载应用 ​

从系统中删除旧的应用安装。如果删除应用不需要用户干预，可以发送请求以从商店中删除应用。

访问范围

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

接口

DELETE /api/202412/oauth2/uninstall 

请求参数

{}

响应数据

{}
bash
curl -X DELETE \ 
https://{shop}.genmystore.com/api/202412/oauth2/uninstall" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{}

GET 获取访问范围 ​

AccessScope 资源允许您检索商家授予应用的权限，例如 read_orders 和 write_products。这些权限允许应用访问商店的数据，并在商家安装应用或更新应用的现有安装时授予。

检索到的访问范围列表基于请求的访问令牌。它仅返回与令牌关联的访问范围。

访问范围

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

接口

GET /api/202412/oauth2/access_scopes 

请求参数

{}

响应数据

accessScopesarray
访问令牌具有的权限列表。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/oauth2/access_scopes" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "accessScopes": "[read_orders,write_orders]"
}