Pour les développeurs

L'API Flavoso

Commandes, carte, horaires d'ouverture, réservations et chiffre d'affaires d'un restaurant, via REST et webhooks. La connexion passe par OAuth 2.0, avec le consentement du propriétaire.

Compte développeur gratuit Démarrage rapide Référence de l'API

Sans établissement à vous et sans abonnement. Un établissement de test avec des données est inclus.

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

Ce que vous pouvez construire

Une application travaille pour le compte d'un établissement, avec exactement les droits que son propriétaire a acceptés. Quelques exemples :

Systèmes de caisseLes commandes arrivent dans la caisse et sont prises en charge avec votre propre numéro de ticket. La caisse gère la carte, les prix et les ruptures, et rapproche le chiffre d'affaires le soir.Logiciels de livraisonPrendre en charge les commandes en livraison avec adresse et heure souhaitée, renvoyer le statut, mettre en pause la prise de commandes aux heures de pointe.ComptabilitéRécupérer le chiffre d'affaires par jour, taux de TVA, mode de paiement et mode de commande, selon les mêmes règles que les chiffres du tableau de bord.RéservationsConsulter les créneaux libres, réserver des tables, confirmer des réservations et installer les clients.AutomatisationRéagir aux événements : nouvelle commande, changement de statut, rupture, pause. Signés, avec nouvelles tentatives et journal.

Votre application appelle l'API REST sous https://api.flavoso.com/v1. Chaque requête porte un jeton d'accès, et chaque jeton appartient à une seule connexion entre votre application et un établissement.

Une connexion naît quand un propriétaire donne son accord à votre application (OAuth 2.0 avec PKCE). Tout ce qui change dans l'établissement, Flavoso le signale à votre serveur par webhook ; une caisse sans adresse publique récupère les mêmes événements avec GET /events.

Votre application

Caisse, livraison, comptabilité, votre propre système

API Flavoso

REST sous api.flavoso.com/v1

Établissement

Page de commande, cuisine, tableau de bord, application mobile

1
Connecter
Le propriétaire donne son accord à votre application (OAuth 2.0). Votre application reçoit des jetons pour cet établissement précis.
2
Interroger
Votre application lit et écrit avec le jeton : commandes, carte, horaires, réservations, chiffre d'affaires.
3
Événements
Flavoso signale chaque changement à votre serveur par webhook, ou votre application les récupère avec GET /events.

Cinq étapes vers votre première intégration

1
Créer un compte
Un compte Flavoso gratuit suffit, sans établissement et sans abonnement.
2
Créer une application et un établissement de test
Dans la console, l'assistant de configuration vous guide : nom, emplacement et droits de l'application, puis l'établissement de test avec carte, tables et outils.
Console
3
Obtenir un jeton de test et envoyer des requêtes
Un clic dans les Identifiants, puis GET /me et GET /orders : deux minutes suffisent.
4
Intégrer OAuth et les webhooks
C'est ainsi que chaque établissement connectera plus tard votre application. Ajoutez-y la réception des événements sur votre serveur.
5
Soumettre à validation
Une fois l'application validée, tout établissement peut la connecter et, si vous le souhaitez, elle apparaît dans l'annuaire des applications.