ConsoleAller au site

API FlavosoRéférence de l'APIConnexion

Connexion

La connexion entre votre application et un établissement. GET /me est le premier appel de toute intégration : quel établissement, quels droits, test ou réel (livemode), quelle offre. DELETE /connection met fin à la connexion de votre côté.

Points de terminaison

Retrieve the connection, its app and its restaurant

get/me

Droit:
tout jeton valide
Offre:
toutes les offres

Works with any valid access token, also while the restaurant's subscription is inactive. The first call of every integration: it answers which restaurant this token belongs to, whether it is a test restaurant (livemode: false), which permissions the connection has and which plan the restaurant is on (reservations need Pro).

Réponse200

OK

  • objectstringobligatoire

    Always connection.

    Valeurs:"connection"

  • idstring (uuid)obligatoire

    The connection, also connection_id in events.

  • livemodebooleanobligatoire

    false for a developer's test restaurant: no guests, no payments, no e-mails, text messages or push notifications.

  • appobjectobligatoire

    Your app.

    Champs contenus (2)
    • client_idstringobligatoire

      The OAuth client id.

    • namestringobligatoire

      The app's name.

  • tenantobjectobligatoire

    The restaurant this token belongs to.

    Champs contenus (6)
    • idstring (uuid)obligatoire

      The restaurant's id (tenant_id in events).

    • namestringobligatoire

      The restaurant's name.

    • slugstringobligatoire

      Its address: <slug>.flavoso.com.

    • timezonestringobligatoire

      IANA time zone, e.g. Europe/Berlin. Local dates and hours are in it.

    • currencystringobligatoire

      ISO 4217 currency of all amounts, e.g. EUR.

    • countrystringobligatoirepeut être null

      ISO 3166-1 alpha-2 country as Flavoso uses it for VAT (from the tax settings, else the address, else the time zone); null when unknown.

  • scopesstring[]obligatoire

    What this token may do (a narrowed token may have fewer than the connection).

    Valeurs:"orders:read""orders:write""menu:read""menu:write""store:read""store:write""reservations:read""reservations:write""reports:read"

  • planstringobligatoire

    The restaurant's plan. Reservations need pro or premium; ordering at the table needs pro.

    Valeurs:"starter""pro""premium"

  • rate_limitobjectobligatoire

    The rate limit of this connection.

    Champs contenus (2)
    • limitintegerobligatoire

      Requests per window.

    • window_secondsintegerobligatoire

      Window length in seconds.

  • created_atstring (date-time)obligatoire

    When the restaurant connected the app. ISO 8601 in UTC (Z).

Erreurs

  • 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
  • 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
  • 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
  • 500server_error. Safe to retry with the same Idempotency-Key.

Tous les codes d'erreur

Requête
curl "https://api.flavoso.com/v1/me" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Réponse
{
  "object": "connection",
  "id": "c41d7e2a-9b3f-4e8c-a015-6d2f8b4e7c19",
  "livemode": true,
  "app": {
    "client_id": "flv_app_9QpR2sT4uV6wX8yZ0aB1cD3e",
    "name": "Kasse Nord"
  },
  "tenant": {
    "id": "8a3e5c7d-2f14-4b9e-a6d1-0c4b7e9f2a35",
    "name": "Trattoria Bella Rosa",
    "slug": "bella-rosa",
    "timezone": "Europe/Berlin",
    "currency": "EUR",
    "country": "DE"
  },
  "scopes": [
    "orders:write",
    "menu:write",
    "store:write"
  ],
  "plan": "pro",
  "rate_limit": {
    "limit": 120,
    "window_seconds": 60
  },
  "created_at": "2026-10-01T09:15:42.118Z"
}

Disconnect your app from the restaurant

delete/connection

Droit:
tout jeton valide
Offre:
toutes les offres

Ends the connection: every token of it is revoked, including the one used for this request, the restaurant's owners are notified by e-mail and your app receives app.disconnected (reason app). To use the restaurant again, the owner has to connect the app again.

Réponse200

OK

  • objectstringobligatoire

    Always connection.

    Valeurs:"connection"

  • idstring (uuid)obligatoire

    The connection that ended.

  • revokedbooleanobligatoire

    Always true.

    Valeurs:true

Erreurs

  • 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
  • 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
  • 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
  • 500server_error. Safe to retry with the same Idempotency-Key.

Tous les codes d'erreur

Requête
curl -X DELETE "https://api.flavoso.com/v1/connection" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Réponse
{
  "object": "connection",
  "id": "c41d7e2a-9b3f-4e8c-a015-6d2f8b4e7c19",
  "revoked": true
}

Une question reste ouverte ? Écrivez à support@flavoso.com en indiquant l'identifiant de X-Request-Id. Il nous permet de retrouver votre requête dans le journal.