Per sviluppatori

L'API di Flavoso

Ordini, menu, orari di apertura, prenotazioni e fatturato di un ristorante, tramite REST e webhook. Il collegamento avviene con OAuth 2.0, con il consenso del titolare.

Account sviluppatore gratuito Guida rapida Riferimento API

Senza un locale tuo e senza abbonamento. Un locale di prova con dati è incluso.

# The test token from the developer console (valid for up to one hour)
export ACCESS_TOKEN="flv_at_..."

curl https://api.flavoso.com/v1/me \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "object": "connection",
  "id": "4b3f7c1e-9a2d-4e8b-b5f6-0c1d2e3f4a5b",
  "livemode": false,
  "app": {
    "client_id": "flv_app_...",
    "name": "Example POS"
  },
  "tenant": {
    "id": "7d0e5b8a-3c41-4f2e-9a6b-1e2d3c4b5a69",
    "name": "Test restaurant",
    "slug": "test-k7q2m9",
    "timezone": "Europe/Berlin",
    "currency": "EUR",
    "country": "DE"
  },
  "scopes": [
    "orders:write",
    "menu:write",
    "store:write",
    "reports:read"
  ],
  "plan": "pro",
  "rate_limit": {
    "limit": 120,
    "window_seconds": 60
  },
  "created_at": "2026-10-04T17:40:00.000Z"
}

Cosa puoi costruire

Un'app lavora per conto di un locale, con esattamente i permessi che il titolare ha accettato. Alcuni esempi:

Sistemi di cassaGli ordini arrivano in cassa e vengono presi in carico con il proprio numero di scontrino. La cassa gestisce menu, prezzi ed esauriti e la sera riconcilia il fatturato.Software per le consegnePrendere in carico gli ordini a domicilio con indirizzo e orario richiesto, comunicare lo stato, mettere in pausa la ricezione degli ordini nei momenti di punta.ContabilitàRecuperare il fatturato per giorno, aliquota, metodo di pagamento e tipo di ordine, con le stesse regole dei numeri della dashboard.PrenotazioniConsultare gli orari liberi, prenotare tavoli, confermare prenotazioni e far accomodare i clienti.AutomazioneReagire agli eventi: nuovo ordine, cambio di stato, esaurito, pausa. Firmati, con nuovi tentativi e registro.

Come funziona

La tua app chiama l'API REST su https://api.flavoso.com/v1. Ogni richiesta include un token di accesso, e ogni token appartiene a un solo collegamento tra la tua app e un locale.

Un collegamento nasce quando un titolare dà il consenso alla tua app (OAuth 2.0 con PKCE). Ciò che cambia nel locale, Flavoso lo segnala al tuo server via webhook; una cassa senza indirizzo pubblico recupera gli stessi eventi con GET /events.

La tua app

Cassa, consegne, contabilità, sistema proprio

API di Flavoso

REST su api.flavoso.com/v1

Locale

Pagina ordini, cucina, dashboard, app per il telefono

1
Collegare
Il titolare dà il consenso alla tua app (OAuth 2.0). La tua app riceve i token proprio per quel locale.
2
Richieste
La tua app legge e scrive con il token: ordini, menu, orari, prenotazioni, fatturato.
3
Eventi
Flavoso segnala ogni modifica al tuo server via webhook, oppure la tua app le recupera con GET /events.

In cinque passi alla prima integrazione

1
Crea un account
Basta un account Flavoso gratuito, senza locale e senza abbonamento.
2
Crea l'app e il locale di prova
Nella console ti guida l'assistente di configurazione: nome, luogo di esecuzione e permessi dell'app, poi il locale di prova con menu, tavoli e strumenti.
Console
3
Ottieni un token di prova e invia richieste
Un clic in Credenziali, poi GET /me e GET /orders. Bastano due minuti.
4
Integra OAuth e webhook
È così che più avanti ogni locale collegherà la tua app. In più, gli eventi arrivano al tuo server.
5
Invia in revisione
Dopo la revisione tutti i locali possono collegare la tua app, che su richiesta compare nell'elenco delle app.