-50 % avec le code BLACKFRIDAY50-20 % avec le code BLACKFRIDAY20
Intégrations et APIToutes les formules

API publique : présentation et clés

L'API Menuthere permet à votre propre caisse ou logiciel d'agir sur votre boutique. Le support Menuthere vous crée une clé avec accès à Orders, à WhatsApp ou aux deux, et votre logiciel appelle les points d'accès avec cette clé. Une clé ne peut jamais voir ni modifier que vos propres données.

Où
Ask Menuthere support for a key
Formule
Le tableau de bord ne verrouille pas les clés d'API selon la formule. L'envoi de modèles WhatsApp nécessite aussi un numéro WhatsApp connecté, disponible à partir de Starter / Pro.
Durée
5 min
Mis à jour

Créer et gérer les clés

Étape 1: Demandez une clé au support Menuthere

Les clés d'API ne sont pas encore dans le tableau de bord : c'est donc le support Menuthere qui les crée. Indiquez au support à quoi sert la clé, par exemple « Billing POS ».

Étape 2: Choisissez son accès

Une clé avec l'accès Orders peut mettre à jour le statut de vos commandes. Une clé avec l'accès WhatsApp peut envoyer des modèles WhatsApp. Ne demandez que ce dont votre logiciel a besoin.

Étape 3: Enregistrez la clé tout de suite

Une clé ne s'affiche qu'une fois, à sa création. Menuthere n'en garde qu'une empreinte : elle ne peut donc pas être affichée de nouveau. Mettez-la aussitôt dans les réglages de votre logiciel. Si vous la perdez, demandez au support de la révoquer et d'en créer une autre.

Utiliser une clé

Envoyez la clé sous la forme Authorization: Bearer ck_live_… depuis votre serveur. Ne la mettez jamais dans une page de navigateur ni dans une appli mobile, car quiconque la lit peut modifier vos commandes. Un exemple en une ligne :

curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'

Point d'accèsAccès nécessairePage
POST /api/v1/orders/{order_id}/statusOrdersAPI : mettre à jour le statut d'une commande
GET /api/v1/whatsapp/templatesWhatsAppAPI : lister et envoyer des modèles WhatsApp
POST /api/v1/whatsapp/send-templateWhatsAppAPI : lister et envoyer des modèles WhatsApp
StatutErreurSignification
401missing_api_key, invalid_api_keyAucune clé envoyée, ou la clé est erronée ou révoquée.
403scope_deniedLa clé n'a pas l'accès dont ce point d'accès a besoin.
429rate_limitedTrop de requêtes cette minute. Chaque clé est limitée par défaut à 120 par minute.
Bon à savoirVous pouvez avoir jusqu'à 10 clés actives. Demandez au support Menuthere de révoquer une clé que vous n'utilisez plus. Tout ce qui l'utilise cesse de fonctionner aussitôt, et une clé révoquée ne peut pas être rétablie.

Questions

Une clé peut-elle voir les commandes d'un autre restaurant ?
Non. Chaque clé appartient à un seul restaurant. Chaque requête est vérifiée par rapport à ce restaurant : une commande d'un autre compte est donc signalée comme introuvable.
J'ai perdu ma clé. Pouvez-vous me la réafficher ?
Non. Seule une empreinte est conservée. Demandez au support Menuthere de révoquer l'ancienne clé et d'en créer une nouvelle, puis mettez à jour votre logiciel.

Vous ne trouvez pas ? Écrivez à help@mail.menuthere.com ou discutez avec nous, de 9 h à 21 h.Centre d'aideTarifsmenuthere.com