FRLangue: Français

API WataDish

Les restaurants des formules Pro et Business relient leurs propres systèmes à leurs commandes, leur menu et leurs réservations de tables sur WataDish. Créez une clé dans votre administration, sous API, et envoyez-la comme jeton bearer.

curl https://watadish.com/api/v1/orders?status=open \
  -H "Authorization: Bearer wdk_…"

JSON en entrée et en sortie, UTF-8, jusqu’à 120 appels par minute et par clé. Une erreur se présente ainsi : {"error": {"code": "…", "message": "…"}} : 401 unauthorized, 403 not_in_plan, 404 not_found, 409 not_allowed, 422 bad_request ou bad_status, 429 too_many.

Commandes

GET /orders?status=open|all&since=2026-10-18T00:00:00Z&limit=50
Vos commandes, les plus récentes d’abord (open : celles en cours de traitement), chacune avec son code, son numéro, son type, son statut, ses lignes et options, ses totaux en unités mineures, sa devise, son paiement, son client, sa livraison, ses horaires et son historique.
GET /orders/{code}
Une commande.
POST /orders/{code}/status {"status": "accepted", "eta": 20}
Faites avancer une commande comme le ferait votre administration : accepted (avec eta en minutes), preparing, ready, out_for_delivery, completed, rejected ou cancelled (avec une raison). Une commande par carte refusée ou annulée est remboursée comme dans l’administration, et les clients sont prévenus comme d’habitude.

Menu

GET /menu
Sections, plats, choix et prix, dans chaque langue du menu.
POST /items/{id}/availability {"available": false}
Un plat épuisé, ou de retour.

Réservations

GET /bookings?from=2026-10-18
Vos réservations de tables à partir d’un jour donné : code, statut, heure, nombre de personnes, nom, téléphone, e-mail et notes.

Webhook

Indiquez une adresse https dans votre administration. WataDish y envoie chaque événement en JSON : order.created, order.updated, booking.created et booking.updated, et ping depuis le bouton de test.

POST https://your.example/hook
X-WataDish-Event: order.created
X-WataDish-Timestamp: 1760787600
X-WataDish-Signature: sha256=…

{"event": "order.created", "sent_at": "…", "order": {…}}

Pour vérifier qu’il vient bien de WataDish, calculez le HMAC-SHA256 de l’horodatage, d’un point et du corps, avec votre secret de signature, et comparez-le à la signature ; refusez un horodatage de plus de cinq minutes. Répondez par un 2xx en moins de trois secondes.

Les coordonnées des clients

L’API montre le numéro, l’e-mail et l’adresse d’un client comme le fait votre administration : en entier sur une commande en cours de traitement et pendant un jour ensuite, puis seulement pour les clients qui ont accepté vos offres. Gardez vos clés et votre secret en lieu sûr, et n’utilisez ce que vous lisez que pour faire tourner votre restaurant.

Les conditions de l’API