インバウンド Webhook

外部システムから Docklify へのイベントプッシュ（例：Shopify 注文）——ログイン不要、HMAC 検証。

エントリポイント#

外部システムは POST /api/integration/webhooks/[code] にイベントを送信します。code はコネクタコード（P0：shopify）です。ログイン不要。プラットフォームはそのテナントの有効かつ公開済みの 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 です。