MenuNode pour les développeurs
Reliez la caisse, le stock, la livraison ou une automatisation à un restaurant sur MenuNode. Tout ce qui suit fonctionne aujourd’hui et figure dans la spécification OpenAPI.
Ouvrir la spécification OpenAPI
L’API (/api/v1)
Une API REST pour un restaurant : lire la carte, les commandes, les réservations et les avis, et changer les prix ou les plats épuisés. L’adresse de base est https://menunode.com/api/v1.
- Chaque appel envoie
Authorization: Bearer <clé>. Les cookies du tableau de bord ne marchent jamais avec cette API. - Limite : 120 appels par minute et par clé. Chaque réponse porte
X-RateLimit-Limit,X-RateLimit-RemainingetX-RateLimit-Reset; au-delà, 429 avecRetry-After. - Les erreurs ont toujours la forme
{"error": {"code": "...", "message": "..."}}. Un id d’un autre restaurant répond 404, comme un id qui n’existe pas. Une méthode que le chemin n’accepte pas répond 405 avec l’en-têteAllow. - Les montants sont du texte à deux décimales (
"12.50") dans la devise du restaurant. - Les listes arrivent par pages : envoyez le
next_cursorde la réponse commecursorpour la suivante.
curl https://menunode.com/api/v1/restaurant \
-H "Authorization: Bearer pat_…"| Chemin | Méthode | Ce qu’il fait | Permission |
|---|---|---|---|
/restaurant | GET | Le restaurant de la clé. Fonctionne avec n’importe quelle permission. | — |
/hours | GET | Horaires, jours spéciaux, horaires de commande et règles de réservation d’un établissement (branch_id). | — |
/menu | GET | Toute la carte avec le prix et la disponibilité de l’instant. | menu:read |
/items/{id} | PATCH | Changer le prix d’un plat ou le marquer épuisé (sold_out_today, sold_out, available). | menu:write |
/orders | GET | Commandes confirmées, de la plus récente à la plus ancienne, filtrées par date, statut et paiement. | orders:read |
/order-links | POST | Un lien vers la page de commande avec le panier rempli : le client confirme et paie là. | menu:read |
/reservations | GET | Réservations confirmées dans l’ordre du calendrier. | reservations:read |
/reviews | GET | Les réponses des clients à « Comment c’était ? ». | reviews:read |
/webhooks | GET POST | Lister et créer des adresses de notification. | webhooks:write |
/webhooks/{id} | GET PATCH DELETE | Voir, changer (notifications, établissement, pause) ou supprimer une adresse. | webhooks:write |
/webhooks/{id}/test · /rotate-secret | POST | Envoyer une notification de test ou changer la clé de signature. | webhooks:write |
/webhooks/{id}/deliveries · …/resend | GET POST | Historique des envois et en renvoyer un. | webhooks:write |
/feeds/menu.json · /feeds/menu.csv | GET | La carte en colonnes fixes, JSON ou CSV, plats masqués compris. | menu:read |
Obtenir une clé
Le propriétaire la crée dans le tableau de bord, dans Paramètres → Intégrations → API pour les intégrations : un nom et les permissions. La clé commence par pat_ et ne s’affiche qu’une fois ; MenuNode ne garde que son empreinte, donc une clé perdue se remplace par une nouvelle et l’ancienne se supprime.
- Une clé appartient à un restaurant. Aucun paramètre ne la dirige vers un autre.
- Une permission d’écriture inclut la lecture (
menu:writelit aussi la carte). - Une clé d’un seul établissement ne voit que ses commandes et réservations. Elle ne peut pas changer le prix ni l’épuisé de toute la carte (403
branch_scoped) ni gérer les notifications (403branch_token_not_allowed).
| Permission | Ce qu’il fait |
|---|---|
menu:read | Lire la carte, les horaires et les fichiers de carte. |
menu:write | Ce qui précède, plus changer les prix et les plats épuisés. |
orders:read | Lire les commandes et recevoir les notifications de commandes et d’additions de table. |
reservations:read | Lire les réservations et la liste d’attente. |
reviews:read | Lire les avis (ils portent le nom et l’e-mail du client). |
webhooks:write | Créer et gérer des adresses de notification. |
Serveurs MCP pour les assistants IA
MCP est le protocole qu’un assistant IA (Claude, ChatGPT et d’autres) utilise pour appeler des outils. MenuNode a deux serveurs.
Le public, à https://menunode.com/mcp, ne demande pas de clé. Il trouve des restaurants, lit leur carte et leurs informations, pose une question à laquelle la carte ne répond pas, montre les horaires libres et, là où le restaurant l’a activé, commande, réserve ou inscrit sur la liste d’attente. Commandes, réservations et liste d’attente se confirment toujours avec un code à 6 chiffres envoyé par e-mail au client.
- Lecture :
search_restaurants,get_restaurant_info,get_menu,get_menu_structured(avecavoid, les allergènes que le client évite),quote_group,list_available_slots,check_availability. - Commandes :
prepare_order_link,create_orderetconfirm_order,get_order_status. - Réservations :
create_reservationetconfirm_reservation,get_reservation,change_reservation,cancel_reservation,create_availability_alertetconfirm_availability_alert. - Liste d’attente :
get_waitlist_status,join_waitlistetconfirm_waitlist,get_waitlist_position,leave_waitlist. - Questions :
ask_restaurant(la réponse du restaurant est publiée dansget_restaurant_info).
Celui du propriétaire, à https://menunode.com/mcp/owner, demande une clé (Authorization: Bearer pat_…). Avec menu:write, l’assistant construit et modifie la carte : sections, plats, prix par horaire, épuisés, traductions, importer une carte depuis un texte (import_menu_from_raw_text) ou la charger en entier (bulk_upsert_menu). D’autres outils demandent leur propre permission : commandes et réservations (orders:read, orders:status, reservations:read, reservations:status), avis, clients (customers:read), liste d’attente, pause des commandes, jours spéciaux et chiffres de la carte. Dans le tableau de bord, Paramètres → Intégrations → Apprenez à votre IA à utiliser votre restaurant prépare la clé et les étapes pour la connecter.
Notifications vers votre système (webhooks)
MenuNode envoie un POST à une adresse https à vous chaque fois qu’il se passe quelque chose. Enregistrez-la dans le tableau de bord (Paramètres → Intégrations) ou avec POST /webhooks. Jusqu’à 10 adresses par restaurant ; chacune choisit ses notifications et, si le restaurant a plusieurs établissements, un seul : elle reçoit alors ses commandes, réservations, liste d’attente, additions, horaires, avis et plats épuisés, et les changements de toute la carte.
Le corps est {id, type, api_version, timestamp, restaurant_id, data}. Une clé ne peut s’abonner qu’aux notifications qu’elle pourrait lire avec ses permissions.
- Pour lier une adresse à un établissement : choisissez-le dans « Quel établissement » du tableau de bord, ou envoyez
branch_iden créant ou en changeant l’adresse (null= tous les établissements). - Signature (Standard Webhooks) : les en-têtes
webhook-id,webhook-timestampetwebhook-signature. La signature estv1,suivi du HMAC-SHA256 en base64 deid.timestamp.corps, avec la partie base64 de votre secretwhsec_…comme clé. Refusez les heures décalées de plus de 5 minutes. - Répondez par un 2XX en moins de 10 secondes. Sinon, 5 nouveaux essais (1 min, 5 min, 30 min, 2 h et 12 h) avec le même
webhook-id: servez-vous-en pour ignorer les doublons. Les redirections ne sont pas suivies. - Une adresse qui répond 410, ou qui échoue sans arrêt pendant plus d’un jour, se désactive seule et le propriétaire reçoit un e-mail.
menu.updatedest regroupé : beaucoup de changements à la suite en envoient un seul, environ une minute après le dernier (au plus 5 minutes après le premier).hours.updatedest regroupé par établissement pendant environ 10 secondes.- Depuis le tableau de bord ou l’API, vous pouvez envoyer une notification de test, voir les derniers envois et en renvoyer un. Le secret de signature ne s’affiche qu’une fois ; perdu, changez-le pour un nouveau.
const { createHmac, timingSafeEqual } = require('node:crypto');
// headers: the request headers; rawBody: the body exactly as received (before JSON.parse).
function verify(secret, headers, rawBody) {
const id = headers['webhook-id'];
const ts = headers['webhook-timestamp'];
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const key = Buffer.from(secret.slice('whsec_'.length), 'base64');
const expected = createHmac('sha256', key).update(id + '.' + ts + '.' + rawBody).digest();
return headers['webhook-signature'].split(' ').some((part) => {
const given = Buffer.from(part.split(',')[1] ?? '', 'base64');
return part.startsWith('v1,') && given.length === expected.length && timingSafeEqual(given, expected);
});
}| Notification | Ce qu’il fait | Permission |
|---|---|---|
order.created | Nouvelle commande | orders:read |
order.status_changed | Changement de statut d'une commande | orders:read |
reservation.created | Nouvelle réservation | reservations:read |
reservation.updated | Modifications d'une réservation | reservations:read |
waitlist.joined | Quelqu'un s'est inscrit sur la liste d'attente | reservations:read |
waitlist.updated | Modifications de la liste d'attente | reservations:read |
menu.updated | Modifications du menu (regroupées par minute) | menu:read |
item.sold_out | Plat épuisé | menu:read |
item.available | Plat de nouveau disponible | menu:read |
order.payment_changed | Paiement d'une commande (signalé, reçu, remboursé) | orders:read |
hours.updated | Horaires modifiés | menu:read |
review.received | Nouvel avis reçu | reviews:read |
order.updated | Commande modifiée (un plat manque ou a été retiré) | orders:read |
bill.issued | L'addition d'une table a été faite | orders:read |
bill.paid | L'addition d'une table a été payée | orders:read |
bill.voided | L'addition d'une table a été annulée | orders:read |
Fichiers de carte et calendrier
- Publics, sans clé :
/m/<restaurant>/menu.jsonet/m/<restaurant>/menu.csv, avec ce que montre la carte (langpour la langue,branchpour un établissement). - Avec une clé
menu:read:/api/v1/feeds/menu.jsonet.csv, plats masqués compris,branch_idpour un établissement.format=metarenvoie le format du catalogue Meta (WhatsApp et Instagram). - Un calendrier des réservations (.ics) à une adresse secrète que le propriétaire crée et révoque dans le tableau de bord.
- Les fichiers répondent
ETaget 304 quand rien n’a changé.
Recettes pour n8n et Make
Pour automatiser sans coder. Dans le tableau de bord, Paramètres → Intégrations, chaque recette télécharge un modèle pour n8n ou Make et le relie à une notification :
- Chaque nouvelle commande dans une feuille Google (
order.created). - Chaque nouvelle réservation dans un groupe Telegram (
reservation.created). - Chaque nouvelle commande par e-mail à une autre personne (
order.created). - Chaque paiement d’une commande dans une feuille Google (
order.payment_changed). - Chaque changement d’horaires par e-mail à qui met à jour vos autres pages (
hours.updated).
Les modèles n8n ont leur propre adresse à chaque téléchargement.
Il vous manque quelque chose ?
Si une intégration a besoin d’une donnée ou d’un chemin qui n’existe pas, écrivez-nous depuis la page contact ou à support@menunode.com.