50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Integrazioni e APITutti i piani

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 Starter / 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"}'

EndpointAccesso necessarioPagina
POST /api/v1/orders/{order_id}/statusOrdersAPI: aggiornare lo stato di un ordine
GET /api/v1/whatsapp/templatesWhatsAppAPI: elencare e inviare modelli WhatsApp
POST /api/v1/whatsapp/send-templateWhatsAppAPI: elencare e inviare modelli WhatsApp
StatoErroreSignificato
401missing_api_key, invalid_api_keyNessuna chiave inviata, oppure la chiave è sbagliata o revocata.
403scope_deniedLa chiave non ha l'accesso che serve a questo endpoint.
429rate_limitedTroppe richieste in questo minuto. Ogni chiave ha di default 120 al minuto.
Da saperePuoi avere fino a 10 chiavi attive. Chiedi all'assistenza Menuthere di revocare una chiave che non usi più. Tutto ciò che la usa smette subito di funzionare, e una chiave revocata non si può ripristinare.

Domande

Una chiave può vedere gli ordini di un altro ristorante?
No. Ogni chiave appartiene a un solo ristorante. Ogni richiesta viene controllata rispetto a quel ristorante, quindi un ordine di un altro account risulta non trovato.
Ho perso la mia chiave. Potete mostrarmela di nuovo?
No. Viene conservata solo un'impronta. Chiedi all'assistenza Menuthere di revocare la vecchia chiave e crearne una nuova, poi aggiorna il tuo software.

Non lo trovi? Scrivi a help@mail.menuthere.com o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com