SuperAPI AI 工具集

shopify-webhooks-events

通用与其它

查看项目

更新于 10-15 23:29

技能介绍

用途:为 Shopify 应用注册并处理 Webhook,覆盖订单、产品、客户、库存、应用生命周期等关键事件,并实现 Shopify App Store 上架强制要求的 GDPR 合规 Webhook。

主要能力:通过 GraphQL 的 webhookSubscriptionCreate 突变配合 WebhookSubscriptionTopic 与 WebhookSubscriptionInput 注册订阅;支持查询现有订阅(webhookSubscriptions)与删除订阅(webhookSubscriptionDelete);对传入请求做 HMAC 校验;按主题分发到处理函数的类型化调度模式;异步处理事件并记录未知主题。

使用方式:第一步用 GraphQL 注册关键事件主题的订阅。第二步在 shopify.app.toml 中配置三个强制 GDPR Webhook(customers/data_request、customers/redact、shop/redact),不能通过 API 配置,其中 api_version 示例为 2025-04 并建议按季度更新。第三步实现三个 GDPR 处理程序:客户数据请求(收集并发送该客户全部数据)、客户清除(删除客户个人数据及指定订单)、商店清除(卸载后 48 小时内删除全部商店数据)。第四步采用事件处理模式,先校验 HMAC,立即返回 200,再异步处理。第五步可列出并管理已有 Webhook。本地测试可用 shopify app webhook trigger --topic orders/create --address http://localhost:3000/webhooks,或用 curl 携带 X-Shopify-Topic、X-Shopify-Shop-Domain、X-Shopify-Hmac-Sha256 等请求头发送测试载荷。

前提条件:已配置 API 凭据的 Shopify 应用、可从互联网访问的 HTTPS 端点(本地可用 shopify app dev tunnel)、用于 HMAC 校验的 API secret。

限制与注意事项:处理程序超过 5 秒会超时,需立即返回 200 并异步处理;Shopify 在超时后会重试,需通过跟踪 webhook ID 实现幂等以避免重复事件;端点不可达会导致投递失败;HMAC 校验失败通常是 API secret 错误,需核对 Partner Dashboard 中的 SHOPIFY_API_SECRET;缺少 GDPR Webhook 会导致 App Store 被拒。资料未提供具体价格或收费信息。