KonsoleZur Website

Flavoso APIAPI-ReferenzVerbindung

Verbindung

Die Verbindung zwischen deiner App und einem Betrieb. GET /me ist der erste Aufruf jeder Anbindung: welcher Betrieb, welche Rechte, Test oder echt (livemode), welcher Tarif. DELETE /connection trennt die Verbindung von deiner Seite aus.

Endpunkte

Retrieve the connection, its app and its restaurant

get/me

Recht:
jedes gültige Token
Tarif:
jeder Tarif

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).

Antwort200

OK

  • objectstringPflicht

    Always connection.

    Werte:"connection"

  • idstring (uuid)Pflicht

    The connection, also connection_id in events.

  • livemodebooleanPflicht

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

  • appobjectPflicht

    Your app.

    Felder darin (2)
    • client_idstringPflicht

      The OAuth client id.

    • namestringPflicht

      The app's name.

  • tenantobjectPflicht

    The restaurant this token belongs to.

    Felder darin (6)
    • idstring (uuid)Pflicht

      The restaurant's id (tenant_id in events).

    • namestringPflicht

      The restaurant's name.

    • slugstringPflicht

      Its address: <slug>.flavoso.com.

    • timezonestringPflicht

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

    • currencystringPflicht

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

    • countrystringPflichtkann null sein

      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[]Pflicht

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

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

  • planstringPflicht

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

    Werte:"starter""pro""premium"

  • rate_limitobjectPflicht

    The rate limit of this connection.

    Felder darin (2)
    • limitintegerPflicht

      Requests per window.

    • window_secondsintegerPflicht

      Window length in seconds.

  • created_atstring (date-time)Pflicht

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

Fehler

  • 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.

Alle Fehlercodes

Anfrage
curl "https://api.flavoso.com/v1/me" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Antwort
{
  "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

Recht:
jedes gültige Token
Tarif:
jeder Tarif

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.

Antwort200

OK

  • objectstringPflicht

    Always connection.

    Werte:"connection"

  • idstring (uuid)Pflicht

    The connection that ended.

  • revokedbooleanPflicht

    Always true.

    Werte:true

Fehler

  • 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.

Alle Fehlercodes

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

Etwas unklar geblieben? Schreib an support@flavoso.com und nenne die Kennung aus X-Request-Id. Damit finden wir deine Anfrage im Protokoll.