Webhooks entrants

Les systèmes externes poussent des événements (p. ex. commandes Shopify) vers Docklify — sans login, vérification HMAC.

Point d’entrée#

Les systèmes externes envoient un POST vers POST /api/integration/webhooks/[code], où code est le code du connecteur (P0 : shopify). Sans login. La plateforme exécute le flux webhook activé et publié du 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": [ … ], … }

Vérification HMAC et routage tenant#

• Quand trigger_config définit webhook_secret, la signature x-shopify-hmac-sha256 est vérifiée.
• Routage : x-shopify-shop-domain est comparé au store_domain de la connexion ; sans correspondance mais candidat unique, il est utilisé ; sinon 404.