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 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ès | Accès nécessaire | Page |
|---|---|---|
| POST /api/v1/orders/{order_id}/status | Orders | API : mettre à jour le statut d'une commande |
| GET /api/v1/whatsapp/templates | API : lister et envoyer des modèles WhatsApp | |
| POST /api/v1/whatsapp/send-template | API : lister et envoyer des modèles WhatsApp |
| Statut | Erreur | Signification |
|---|---|---|
| 401 | missing_api_key, invalid_api_key | Aucune clé envoyée, ou la clé est erronée ou révoquée. |
| 403 | scope_denied | La clé n'a pas l'accès dont ce point d'accès a besoin. |
| 429 | rate_limited | Trop de requêtes cette minute. Chaque clé est limitée par défaut à 120 par minute. |
Questions
Une clé peut-elle voir les commandes d'un autre restaurant ?
J'ai perdu ma clé. Pouvez-vous me la réafficher ?
Voir aussi
Vous ne trouvez pas ? Écrivez à [email protected] ou discutez avec nous, de 9 h à 21 h.Centre d'aideTarifsmenuthere.com