API

Une API documentée pour les intégrations

Un site, un agrégateur ou un service de livraison travaille avec la clé de l’établissement. La clé n’est valable que pour un seul établissement, se révoque instantanément et ne donne pas accès aux données des autres établissements — c’est garanti par l’architecture du système, et non par une vérification séparée.

Back office: website section — storefront with dish photos from the till menu

Ce que permet l’intégration

📋

Carte et disponibilité

La vitrine reçoit les catégories, les plats, les prix, les suppléments et les photos — déjà sans les articles retirés de la vente, et avec l’indication « l’établissement n’accepte pas de commandes en ce moment ».

🧾

Réception de la commande

La commande est créée en un seul appel et reçoit un numéro. Répéter le même appel ne crée pas de seconde commande.

✏️

Modification et annulation

Tant que l’établissement n’a pas accepté la commande, la source peut en modifier le contenu ou l’annuler.

🎟

Vérification du code promo

Le coupon est vérifié côté POSitive : la remise sur la vitrine et à la caisse ne diverge donc pas.

💳

Notification de paiement

Le paiement accepté côté vitrine est rattaché au moyen de paiement de l’établissement — l’argent arrive sur le bon compte.

↩️

Statuts en retour

Acceptée, en préparation, remise au coursier, terminée — les notifications partent vers la source et sont signées par un secret partagé.

La spécification n’est pas publiée. Les adresses des méthodes, la composition des champs, les codes d’erreur et les exemples de requêtes sont fournis avec la clé — à l’établissement, à son développeur ou au partenaire. La raison est simple : un contrat affiché sur une vitrine aide moins l’intégrateur que celui qui cherche les intégrations des autres. La description s’obtient en une seule demande, et nous répondons le jour même.

Ce que garantit le contrat

🔁

Idempotence

Renvoyer une requête avec la même clé d’opération ne crée pas de seconde commande. Protège contre le double clic et les coupures de connexion.

🔐

Signature et clés

La clé est valable pour un seul établissement et se révoque instantanément. Le secret est stocké sous forme de hachage et ne peut être récupéré, même par nous. La clé reste sur le serveur du partenaire, pas dans le navigateur du client.

🧾

Erreurs explicites

La réponse indique précisément quel article n’est pas passé et pourquoi — au lieu d’un « 400 Bad Request » générique.

🛑

Plats épuisés à jour

La carte est transmise sans les articles retirés de la vente : un article retiré à la caisse disparaît aussitôt du site.

↩️

Canal de retour

Le statut de la commande est renvoyé à la source : acceptée, en préparation, remise au coursier, terminée.

🧪

Bac à sable

Un établissement de test avec sa propre clé : l’intégration peut être construite et vérifiée sans toucher aux données réelles.

Besoin d’une clé ou du contrat ?

Nous envoyons la description avec les champs et des exemples, ouvrons le bac à sable et répondons aux questions sur l’intégration.