Aller au contenu

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-Remaining et X-RateLimit-Reset ; au-delà, 429 avec Retry-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ête Allow.
  • Les montants sont du texte à deux décimales ("12.50") dans la devise du restaurant.
  • Les listes arrivent par pages : envoyez le next_cursor de la réponse comme cursor pour la suivante.
Un appel avec votre clé
curl https://menunode.com/api/v1/restaurant \
  -H "Authorization: Bearer pat_…"
Chemins de /api/v1
CheminMéthodeCe qu’il faitPermission
/restaurantGETLe restaurant de la clé. Fonctionne avec n’importe quelle permission.—
/hoursGETHoraires, jours spéciaux, horaires de commande et règles de réservation d’un établissement (branch_id).—
/menuGETToute la carte avec le prix et la disponibilité de l’instant.menu:read
/items/{id}PATCHChanger le prix d’un plat ou le marquer épuisé (sold_out_today, sold_out, available).menu:write
/ordersGETCommandes confirmées, de la plus récente à la plus ancienne, filtrées par date, statut et paiement.orders:read
/order-linksPOSTUn lien vers la page de commande avec le panier rempli : le client confirme et paie là.menu:read
/reservationsGETRéservations confirmées dans l’ordre du calendrier.reservations:read
/reviewsGETLes réponses des clients à « Comment c’était ? ».reviews:read
/webhooksGET POSTLister et créer des adresses de notification.webhooks:write
/webhooks/{id}GET PATCH DELETEVoir, changer (notifications, établissement, pause) ou supprimer une adresse.webhooks:write
/webhooks/{id}/test · /rotate-secretPOSTEnvoyer une notification de test ou changer la clé de signature.webhooks:write
/webhooks/{id}/deliveries · …/resendGET POSTHistorique des envois et en renvoyer un.webhooks:write
/feeds/menu.json · /feeds/menu.csvGETLa 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:write lit 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 (403 branch_token_not_allowed).
Permissions d’une clé
PermissionCe qu’il fait
menu:readLire la carte, les horaires et les fichiers de carte.
menu:writeCe qui précède, plus changer les prix et les plats épuisés.
orders:readLire les commandes et recevoir les notifications de commandes et d’additions de table.
reservations:readLire les réservations et la liste d’attente.
reviews:readLire les avis (ils portent le nom et l’e-mail du client).
webhooks:writeCré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 (avec avoid, les allergènes que le client évite), quote_group, list_available_slots, check_availability.
  • Commandes : prepare_order_link, create_order et confirm_order, get_order_status.
  • Réservations : create_reservation et confirm_reservation, get_reservation, change_reservation, cancel_reservation, create_availability_alert et confirm_availability_alert.
  • Liste d’attente : get_waitlist_status, join_waitlist et confirm_waitlist, get_waitlist_position, leave_waitlist.
  • Questions : ask_restaurant (la réponse du restaurant est publiée dans get_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_id en créant ou en changeant l’adresse (null = tous les établissements).
  • Signature (Standard Webhooks) : les en-têtes webhook-id, webhook-timestamp et webhook-signature. La signature est v1, suivi du HMAC-SHA256 en base64 de id.timestamp.corps, avec la partie base64 de votre secret whsec_… 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.updated est 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.updated est 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.
Vérifier la signature d’une notification (Node.js)
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);
  });
}
Notifications que vous pouvez recevoir
NotificationCe qu’il faitPermission
order.createdNouvelle commandeorders:read
order.status_changedChangement de statut d'une commandeorders:read
reservation.createdNouvelle réservationreservations:read
reservation.updatedModifications d'une réservationreservations:read
waitlist.joinedQuelqu'un s'est inscrit sur la liste d'attentereservations:read
waitlist.updatedModifications de la liste d'attentereservations:read
menu.updatedModifications du menu (regroupées par minute)menu:read
item.sold_outPlat épuisémenu:read
item.availablePlat de nouveau disponiblemenu:read
order.payment_changedPaiement d'une commande (signalé, reçu, remboursé)orders:read
hours.updatedHoraires modifiésmenu:read
review.receivedNouvel avis reçureviews:read
order.updatedCommande modifiée (un plat manque ou a été retiré)orders:read
bill.issuedL'addition d'une table a été faiteorders:read
bill.paidL'addition d'une table a été payéeorders:read
bill.voidedL'addition d'une table a été annuléeorders:read

Fichiers de carte et calendrier

  • Publics, sans clé : /m/<restaurant>/menu.json et /m/<restaurant>/menu.csv, avec ce que montre la carte (lang pour la langue, branch pour un établissement).
  • Avec une clé menu:read : /api/v1/feeds/menu.json et .csv, plats masqués compris, branch_id pour un établissement. format=meta renvoie 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 ETag et 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.