# Introduzione

> Cosa espone oggi l'API Partner di BackResto, cosa deliberatamente non espone e chi decide.

Source: https://developers.backresto.com/it/docs/introduction

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](https://api.backresto.com/openapi.json) 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](https://developers.backresto.com/it/docs/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](https://developers.backresto.com/it/docs/access), 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

| Risorsa | Che cos'è |
| --- | --- |
| [Consegne](https://developers.backresto.com/it/docs/deliveries) | Due collezioni: un record per ogni controllo in accettazione (fornitore, verdetto di conformità, motivi di non conformità, azioni correttive, commento in testo libero, una lettura di temperatura per prodotto, sempre in Celsius), e le immagini scattate al ricevimento. |
| [Collezioni e record](https://developers.backresto.com/it/docs/collections) | Altri ventiquattro tipi di record, che condividono un solo involucro e sono documentati per dominio: [temperature](https://developers.backresto.com/it/docs/temperatures), [raffreddamento e processi alimentari](https://developers.backresto.com/it/docs/food-processes), [pulizie](https://developers.backresto.com/it/docs/cleaning), [friggitrici](https://developers.backresto.com/it/docs/fryers), [analisi di superficie](https://developers.backresto.com/it/docs/surface-analyses), [etichette di tracciabilità](https://developers.backresto.com/it/docs/traceability-labels), [documenti](https://developers.backresto.com/it/docs/drive-files), [catalogo](https://developers.backresto.com/it/docs/catalogue) e le [strutture e le persone](https://developers.backresto.com/it/docs/facilities) che ci stanno dietro. |

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](https://developers.backresto.com/it/docs/support).
- **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](https://developers.backresto.com/it/docs/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

| Ambiente | Origine |
| --- | --- |
| Produzione | `https://api.backresto.com` |
| Pre-produzione | `https://api-preprod.backresto.com` |
| Sviluppo | `https://api-dev.backresto.com` |

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](https://developers.backresto.com/it/docs/quickstart).