Documentazione
L'API Partner di BackResto, dall'inizio alla fine. Cominci dalla guida rapida se possiede già una chiave.
Per iniziare
Che cos'è l'API Partner e come effettuare la prima chiamata.
Introduzione
Cosa espone oggi l'API Partner di BackResto, cosa deliberatamente non espone e chi decide.
Ottenere una chiave
Come richiedere una chiave dell'API Partner, cosa indicare nella richiesta e cosa si riceve.
Guida rapida
Da una chiave ai suoi primi record e a una fotografia di consegna in cinque minuti, con curl.
Concetti fondamentali
Autenticazione, errori, paginazione e limiti di frequenza.
Autenticazione
Le chiavi partner, i ventisei scope, cosa significa una concessione e come ruotare senza interruzioni.
Errori
Un unico documento di problema leggibile dalle macchine per ogni errore, e cosa significa ciascun tipo per la sua logica di retry.
Paginazione
Come percorrere qualsiasi collezione con un cursore opaco, e come tenerne aggiornata una copia.
Limiti di frequenza
Il budget per chiave, l'unico header che lo descrive e come restare al di sotto.
Risorse
Gli endpoint, campo per campo.
Collezioni e record
Le ventisei collezioni di record, l'involucro di snapshot che condividono e come percorrerne una.
Temperature
Temperature dei frigoriferi e di cottura, rilevate da una persona o riportate da un sensore: tre collezioni, e ciò che le distingue.
Etichette di tracciabilità
Le etichette secondarie che il personale stampa e applica su un contenitore, con il file stampato allegato e un id di gruppo per ogni lotto di stampa.
Consegne
I controlli in accettazione e le fotografie scattate al ricevimento: due collezioni, ogni campo, e cosa significano in cucina.
Pulizie
Il piano di pulizia, i compiti effettivamente svolti e le fotografie che lo dimostrano: tre collezioni, e cosa non prova un record mancante.
Friggitrici
Le friggitrici e i loro controlli sulla qualità dell'olio: due collezioni, e perché il valore misurato può mancare mentre la decisione non manca mai.
Raffreddamento e processi alimentari
Raffreddamento, congelamento, riscaldamento e trasporto: quattro collezioni che registrano una transizione di temperatura, e che aspetto ha quella rimasta incompiuta.
Analisi di superficie
Tamponi di superficie: cosa è stato analizzato, se ha superato la prova e il piano d'azione quando non l'ha superata.
Documenti
L'archivio documenti del ristorante (certificati, procedure, report), dove ogni record è un file archiviato con il proprio tipo di media.
Catalogo
Fornitori, prodotti e preparazioni interne: gli elenchi di riferimento che tutto il resto del registro indica.
Strutture e persone
La sede, il suo personale, le sue zone e le sue macchine: la mappa fissa a cui si aggancia ogni lettura di temperatura.
Agenti e MCP
Collegare BackResto a un client IA tramite MCP.
Server MCP
Colleghi Claude, Cursor, Codex o qualsiasi client MCP ai registri di conformità di un ristorante con un URL e la sua chiave API.
Supporto
Versionamento, limiti dei dati attuali e come contattarci.
Supporto e completezza dei dati
Cosa coprono e cosa non coprono i dati attuali, come è versionata l'API e come raggiungere una persona.