批量任务状态更新

事件分组	事件标识
others	others/update

请求头

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

请求体

completedAt string

批量任务的完成时间。格式：ISO 8601。
例子: 2023-04-06T10:48:29+08:00
completedCount integer

批量操作的完成数量。
createdAt string

批量任务的创建时间。格式：ISO 8601。
例子: 2023-04-06T10:48:29+08:00
expiredAt string

批量任务的过期时间，超过该时间文件将无法下载。格式：ISO 8601。
例子: 2023-04-06T10:48:29+08:00
id string

批量操作任务 ID。
例子: gid://shopline/BulkOperation/f97a8c3304b98bcee17c12a0ceb85573
status string
批量任务状态。有效枚举值包含：
- CANCELED：已取消
- CANCELING：取消中
- COMPLETED：已完成
- CREATED：已创建
- EXPIRED：已过期
- FAILED：已失败
- RUNNING：运行中
type string
批量任务操作类型。有效枚举值包含：
- QUERY：查询操作
- MUTATION：变更操作，指通过创建一个批量变更任务（待废弃）接口执行的变更操作。
- MUTATION_GENERAL：变更操作
url string

带有过期时间的文件 URL，包含所有任务处理结果。文件格式：JSON Lines。
例子: https://sl-private-oss.oss-accelerate.example.com/task-jsonline/prod/1/9b0c0f04-53cb-4ae3-94db-79af6ec193bd.jsonl?Expires=1754059510

状态码

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

HTTP/1.1 200 OK

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

这篇文章对你有帮助吗？

SHOPLINE

SHOPLINE

条款协议

隐私