Webhooks de entrada

Sistemas externos enviam eventos (ex. pedidos Shopify) ao Docklify — sem login, verificação HMAC.

Ponto de entrada#

Sistemas externos enviam POST para POST /api/integration/webhooks/[code], onde code é o código do conector (P0: shopify). Sem login. A plataforma executa o fluxo webhook habilitado e publicado do tenant.

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": [ … ], … }

Verificação HMAC e roteamento de tenant#

• Quando trigger_config define webhook_secret, a assinatura x-shopify-hmac-sha256 é verificada.
• Roteamento: x-shopify-shop-domain é comparado ao store_domain da conexão; sem correspondência mas candidato único, é usado; senão, 404.