Skip to main content

Webhooks

Les webhooks permettent à ClientManager de notifier les serveurs en temps réel lorsque le statut d'une commande change. Cela garantit que les serveurs sont toujours informés des mises à jour importantes concernant les commandes qu'ils gèrent.

Ce webhook est appelé par le gérant lorsqu’une commande change de statut.
Les serveurs reçoivent une notification push si la commande est VALIDATE.

Endpoint POST /webhook/order-status​

Headers​

  • Content-Type: application/json
  • x-webhook-secret: SECRET (clé secrète)

Body​

{
  "orderId": "ORD123",
  "status": "VALIDATE",
  "tableId": "table123"
}

Réponses​

  • 200 OK

    {
        "ok": true
    }

  • 400 Bad Request : Requête mal formée (ex: orderId ou status manquant).

    {
        "error": "orderId and status are required"
    }

  • 401 Unauthorized : Clé secrète invalide.

    {
        "error": "invalid secret"
    }

  • 500 Internal Server Error : Erreur serveur.

    {
        "error": "Internal server error"
    }

Exemple de requête avec curl​

curl -X POST https://ton-api.onrender.com/webhook/order-status \
  -H "Content-Type: application/json" \
  -H "x-webhook-secret: VOTRE_SECRET" \
  -d '{"orderId":"ORD123","status":"VALIDATE","tableId":"table123"}'