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 — un ERP, un portale fornitori, un cruscotto qualità, un assistente IA.

È un'API HTTP in sola lettura con uno schema di autenticazione e una 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 ambiti indicati, e solo dopo che i ristoranti in questione hanno dato il loro consenso. La richieda via email — Ottenere una chiave è la lista di controllo — 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

Le consegne sono una risorsa progettata; le collezioni le consegnano il record così come lo tiene l'app, in un unico involucro generico. La seconda è il modo in cui un modulo raggiunge questa API la settimana in cui viene rilasciato anziché il trimestre successivo.

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. Non consideri un intervallo vuoto come prova che non sia successo nulla — veda Supporto.
• Nessuna scrittura, nessun webhook. Si interroga l'API. 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. Le consegne, che sono immutabili, accettano invece un intervallo di tempo.
• Nessun accesso OAuth. Ogni client si autentica con una chiave, anche via MCP. Gli strumenti che pretendono una pagina di accesso non possono ancora collegarsi.

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.