Introduzione

BackResto è l'app di conformità HACCP che i team della ristorazione compilano durante il servizio: controlli in accettazione, temperature di cottura e raffreddamento, piani di pulizia, etichette. L'API Partner consegna quel registro al software che i suoi clienti già utilizzano, che sia un ERP, un portale fornitori, un cruscotto qualità o un assistente IA.

È un'API HTTP in sola lettura con un solo schema di autenticazione e una sola forma di errore, descritta dall'inizio alla fine da un documento OpenAPI che può caricare direttamente in un generatore di client o in una definizione di tool per un LLM. Gli stessi dati sono raggiungibili via MCP all'indirizzo https://api.backresto.com/mcp, con la stessa chiave e gli stessi permessi, se quello che vuole è fare domande anziché scrivere un client.

È il ristorante a decidere cosa vede

Questa è la parte che vale la pena leggere due volte, perché è diversa da quasi tutte le API con cui si troverà a integrarsi.

Non esiste registrazione. Una chiave viene emessa a mano, limitata a ristoranti indicati e scope indicati, e solo dopo che i ristoranti in questione hanno dato il loro consenso. La richieda via email, seguendo la lista di controllo in Ottenere una chiave, e arriva al contatto tecnico che indica.

La conseguenza è netta: una chiave raggiunge i ristoranti per cui è stata concessa e nient'altro. restaurant-3 non compare perché restaurant-1 e restaurant-2 sono sulla stessa chiave, e nessuna richiesta che lei possa fare amplia tale perimetro. Aggiungere una sede è un'altra conversazione, con le persone di cui sono i dati.

Il vantaggio di un piccolo passaggio manuale è che la revoca è altrettanto diretta: una email e la chiave è morta alla richiesta successiva.

Cosa contengono i dati

Tutto è in sola lettura. Nulla che una chiave partner possa chiamare scrive nei registri di un ristorante: l'app è il luogo in cui i dati di conformità vengono creati, dalla persona che ne risponde.

Cosa non c'è ancora

Essere espliciti sui limiti le fa risparmiare un pomeriggio:

• Nessun recupero dello storico. I record di un ristorante diventano visibili a questa API dal momento in cui l'acquisizione viene attivata per quel ristorante. Ciò che è venuto prima è nell'app, non qui, tranne per le consegne, che riportano lo storico che l'app conservava ancora. Non consideri un percorso vuoto come prova che non sia successo nulla. Veda Supporto.
• Nessuna scrittura, nessun webhook. Si fa polling. Se ha bisogno di ricevere notifiche push, ce lo dica; è una questione di domanda, non di principio.
• Nessun cursore incrementale sulle collezioni. Aggiornare una collezione significa percorrerla di nuovo e riconciliare su id.
• Nessun accesso con un account BackResto. La chiave partner resta la credenziale. I client MCP che chiedono solo un URL, come Claude e ChatGPT, possono collegarsi via OAuth: si apre una pagina BackResto in cui incollare la chiave. I permessi restano quelli della chiave.

URL di base

Una chiave viene predisposta in un solo ambiente e non significa nulla negli altri: chiavi, concessioni e dati sono per ambiente. Tutto ciò che segue usa l'origine di produzione.

Pronto? Effettui la sua prima chiamata.