简体中文

English

简体中文

English

显示模式

关于 应用 ​

访问范围

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

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

Genstore 应用包含平台自研应用和第三方开发者构建的应用。这些应用通过集成 Genstore 平台的基础功能，为商家提供更丰富的运营解决方案。开发者可以利用 Genstore 的开放 API 与开发工具，构建新的扩展功能或实现与外部服务的集成。

应用模块是 Genstore 的应用管理模块，通过 REST APIs 与 Webhooks 提供应用数据统计和状态同步能力。

核心功能

  • 事件系统：基于 Webhook 的应用生命周期事件通知系统。 -监控系统：用于应用性能和健康度监控的 API 接口。

应用场景

  • 应用状态同步：当应用需要感知商家安装与卸载时，应用可以订阅应用安装主题（app/installed），用于处理商家安装应用时预处理。
  • 应用数据统计：如开发者需要监控应用的运行状态，也可以通过应用的数据统计 API 来感知应用当前运行的健康情况。

接口

EVENT app/scopesUpdate: 应用scope变更消息

EVENT app/uninstalled: 应用卸载完成消息

应用 对象 ​

应用对象是应用在被商家安装时而生成的应用实例数据。

属性 ​

appobject
应用安装信息。
- 收起属性
clientIdstring
应用的客户端 ID。
shopIdnumber
当前商店的唯一标识符。
bash
{
  "app": {
    "clientId": "58DAED6AEC7AA1C2C8DFD719E8E06E3A",
    "shopId": "4022054969604"
  }
}

EVENT 应用scope变更消息 ​

每当修改任何安装的访问范围时都会发生。允许应用跟踪其安装的已授予访问范围。

访问范围

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

消息

EVENT app/scopesUpdate 

消息数据

authScopeobject
授权访问范围信息。
- 收起属性
clientIdstring
应用的客户端 ID。
shopIdnumber
当前商店的唯一标识符。
previousarray
更新之前的应用访问范围。
currentarray
当前的应用访问范围。
updateTimenumber
访问范围更新的毫秒时间戳。
json
{
  "authScope": {
    "current": "[read_order,write_order]",
    "clientId": "58DAED6AEC7AA1C2C8DFD719E8E06E3A",
    "previous": "[read_order]",
    "updateTime": "1732864257361",
    "shopId": "4022054969604"
  }
}

EVENT 应用卸载完成消息 ​

当商店卸载应用程序时发生。

访问范围

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

消息

EVENT app/uninstalled 

消息数据

uninstalledobject
卸载信息。
- 收起属性
clientIdstring
应用的客户端 ID。
shopIdnumber
当前商店的唯一标识符。
json
{
  "uninstalled": {
    "clientId": "58DAED6AEC7AA1C2C8DFD719E8E06E3A",
    "shopId": "4022054969604"
  }
}