入站 Webhook

外部系统向 Docklify 推送事件（如 Shopify 订单）——无需登录，HMAC 校验。

入口#

外部系统向 POST /api/integration/webhooks/[code] 发送事件，code 为连接器编码（P0：shopify）。无需登录。平台按 code 找到该租户已启用且已发布的 webhook 触发器流程并执行。

POST /api/integration/webhooks/shopify
x-shopify-topic: orders/create
x-shopify-shop-domain: my-store.myshopify.com
x-shopify-hmac-sha256: <hmac-signature>
Content-Type: application/json

{ "id": 123456789, "order_number": 1001, "line_items": [ … ], … }

HMAC 校验与租户路由#

• 流程 trigger_config 配置了 webhook_secret 时会校验 x-shopify-hmac-sha256 签名——未签名请求将被拒绝。
• 租户路由：用 x-shopify-shop-domain 匹配连接配置的 store_domain；匹配不到但候选唯一时用该候选，否则 404。