API pubblica: panoramica e chiavi
L'API di Menuthere permette alla tua cassa (POS) o al tuo software di agire sul tuo negozio. L'assistenza Menuthere crea per te una chiave con accesso a Orders, WhatsApp o a entrambi, e il tuo software chiama gli endpoint con essa. Una chiave può vedere e modificare solo i tuoi dati.
- Dove
- Ask Menuthere support for a key
- Piano
- La dashboard non blocca le chiavi API in base al piano. Per inviare modelli WhatsApp serve anche un numero WhatsApp collegato, disponibile dal piano Pro.
- Tempo
- 5 min
- Aggiornato
Crea e gestisci le chiavi
Passo 1: Chiedi una chiave all'assistenza Menuthere
Le chiavi API non sono ancora nella dashboard, quindi le crea l'assistenza Menuthere. Di' all'assistenza a cosa serve la chiave, ad esempio «Billing POS».
Passo 2: Scegli il suo accesso
Una chiave con accesso Orders può aggiornare lo stato dei tuoi ordini. Una con accesso WhatsApp può inviare modelli WhatsApp. Chiedi solo ciò che serve al tuo software.
Passo 3: Salva subito la chiave
Una chiave viene mostrata una sola volta, quando viene creata. Menuthere ne conserva solo un'impronta, quindi non può essere mostrata di nuovo. Mettila subito nelle impostazioni del tuo software. Se la perdi, chiedi all'assistenza di revocarla e di crearne un'altra.
Usare una chiave
Invia la chiave come Authorization: Bearer ck_live_… dal tuo server. Non metterla mai in una pagina del browser o in un'app mobile, perché chiunque la legga può modificare i tuoi ordini. Un esempio in una riga:
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"}'
| Endpoint | Accesso necessario | Pagina |
|---|---|---|
| POST /api/v1/orders/{order_id}/status | Orders | API: aggiornare lo stato di un ordine |
| GET /api/v1/whatsapp/templates | API: elencare e inviare modelli WhatsApp | |
| POST /api/v1/whatsapp/send-template | API: elencare e inviare modelli WhatsApp |
| Stato | Errore | Significato |
|---|---|---|
| 401 | missing_api_key, invalid_api_key | Nessuna chiave inviata, oppure la chiave è sbagliata o revocata. |
| 403 | scope_denied | La chiave non ha l'accesso che serve a questo endpoint. |
| 429 | rate_limited | Troppe richieste in questo minuto. Ogni chiave ha di default 120 al minuto. |
Domande
Una chiave può vedere gli ordini di un altro ristorante?
Ho perso la mia chiave. Potete mostrarmela di nuovo?
Vedi anche
Non lo trovi? Scrivi a [email protected] o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com