Für Entwickler

Die Flavoso-API

Bestellungen, Speisekarte, Öffnungszeiten, Reservierungen und Umsätze eines Restaurants, per REST und Webhooks. Verbunden wird per OAuth 2.0, mit der Zustimmung des Inhabers.

Kostenloses Entwicklerkonto Schnellstart API-Referenz

Ohne eigenen Betrieb und ohne Abo. Ein Test-Betrieb mit Daten ist inklusive.

# 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"
}

Was du bauen kannst

Eine App arbeitet im Auftrag eines Betriebs, mit genau den Rechten, denen der Inhaber zugestimmt hat. Ein paar Beispiele:

KassensystemeBestellungen landen in der Kasse und werden mit eigener Belegnummer übernommen. Die Kasse pflegt Speisekarte, Preise und Ausverkauft und gleicht abends den Umsatz ab.Lieferdienst-SoftwareLieferbestellungen mit Anschrift und Zeitwunsch übernehmen, den Stand zurückmelden, bei Hochbetrieb die Bestellannahme pausieren.BuchhaltungUmsätze je Tag, Steuersatz, Zahlart und Bestellart abrufen, mit denselben Regeln wie die Zahlen im Dashboard.ReservierungenFreie Zeiten abfragen, Tische buchen, Reservierungen bestätigen und Gäste platzieren.AutomatisierungAuf Ereignisse reagieren: neue Bestellung, Statuswechsel, ausverkauft, Pause. Signiert, mit Wiederholung und Protokoll.

Deine App ruft die REST-Schnittstelle unter https://api.flavoso.com/v1 auf. Jede Anfrage trägt ein Access-Token, und jedes Token gehört zu genau einer Verbindung zwischen deiner App und einem Betrieb.

Eine Verbindung entsteht, wenn ein Inhaber deiner App zustimmt (OAuth 2.0 mit PKCE). Was sich im Betrieb ändert, meldet Flavoso per Webhook an deinen Server; eine Kasse ohne öffentliche Adresse holt dieselben Ereignisse mit GET /events ab.

Deine App

Kasse, Lieferdienst, Buchhaltung, eigenes System

Flavoso-API

REST unter api.flavoso.com/v1

Betrieb

Bestellseite, Küche, Dashboard, Handy-App

1
Verbinden
Der Inhaber stimmt deiner App zu (OAuth 2.0). Deine App bekommt Tokens für genau diesen Betrieb.
2
Anfragen
Deine App liest und schreibt mit dem Token: Bestellungen, Karte, Zeiten, Reservierungen, Umsätze.
3
Ereignisse
Flavoso meldet jede Änderung per Webhook an deinen Server, oder deine App holt sie mit GET /events ab.

In fünf Schritten zur ersten Anbindung

1
Konto anlegen
Ein kostenloses Flavoso-Konto reicht, ohne Betrieb und ohne Abo.
2
App und Test-Betrieb anlegen
In der Konsole führt dich der Einrichtungs-Assistent: Name, Ort und Rechte der App, dann der Test-Betrieb mit Speisekarte, Tischen und Werkzeugen.
Konsole
3
Test-Token holen und anfragen
Ein Klick unter Zugangsdaten, dann GET /me und GET /orders. Zwei Minuten.
4
OAuth und Webhooks einbauen
So verbindet später jeder Betrieb deine App. Dazu die Ereignisse an deinen Server.
5
Zur Freigabe einreichen
Nach der Prüfung können alle Betriebe deine App verbinden, und auf Wunsch erscheint sie im App-Verzeichnis.