应用安装状态变更

事件分组	事件标识
apps	apps/installed_uninstalled

当商店安装或卸载应用时，平台会向应用发送事件通知。

请求头

X-Shopline-Topic string required

事件的唯一标识。

例子: orders/edited
X-Shopline-Hmac-Sha256 string required

该请求的签名。收到请求后，你需要对该签名进行验签以验证数据的真实性和完整性。

例子: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
X-Shopline-Shop-Domain string required

店铺的域名。

例子: example.myshopline.com
X-Shopline-Shop-Id string required

店铺 ID。

例子: 1610418123456
X-Shopline-Merchant-Id string required

商家 ID。

例子: 2000001234
X-Shopline-API-Version string required

API 版本号。

例子: v20250601
X-Shopline-Webhook-Id string required

该 Webhook 事件的 ID。

例子: b54557e48a5fbf7d70bcd043

请求体

appkey string

应用的全局唯一标识符。
例子: 35f91ba37b941e6ce5fcc67975ab7aafb0a12345
country_code string

店铺所在的国家或地区，遵循 ISO 3166-1 (alpha 2) 国际标准的二位国家或区域码。
例子: US
created_at string

事件发生的精确时间。
格式：ISO 8601，时区为店铺所在时区。

note
created_at 和 timestamp 是等价的，用于兼容不同开发者的需求。
例子: 2024-04-01T14:01:23+08:00
handle string

店铺在 SHOPLINE 系统中的唯一标识符，对应域名中 {handle}.myshopline.com 的 {handle} 部分。
例子: smartstore
merchant_id string

商户的全局唯一标识符 ID，用于识别商户。
例子: 2000001234
name string

店铺当前显示名称（商家可修改的非固定标识）。
例子: SHOPLINE Store
operate string
当前执行的操作类型。有效枚举值包含：
- INSTALL：应用安装
- UNINSTALL：应用卸载
store_id string

店铺的全局唯一标识符 ID。
例子: 1610418123456
timestamp long

事件发生的时间。格式为 13 位毫秒级时间戳。

note
created_at 和 timestamp 是等价的，用于兼容不同开发者的需求。
例子: 1293941471000
timezone string
店铺使用的 IANA 时区标识符。

例如：
- America/New_York: 美国东部时间
- Asia/Tokyo: 日本标准时间

状态码

收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。

HTTP/1.1 200 OK

关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 Webhook 概述。

这篇文章对你有帮助吗？

SHOPLINE

SHOPLINE

条款协议

隐私