ConsoleVai al sito

API di FlavosoRiferimento APICollegamento

Collegamento

Il collegamento tra la tua app e un locale. GET /me è la prima chiamata di ogni integrazione: quale locale, quali permessi, prova o reale (livemode), quale piano. DELETE /connection chiude il collegamento dal tuo lato.

Endpoint

Retrieve the connection, its app and its restaurant

get/me

Permesso:
qualsiasi token valido
Piano:
tutti i piani

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

Risposta200

OK

  • objectstringobbligatorio

    Always connection.

    Valori:"connection"

  • idstring (uuid)obbligatorio

    The connection, also connection_id in events.

  • livemodebooleanobbligatorio

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

  • appobjectobbligatorio

    Your app.

    Campi interni (2)
    • client_idstringobbligatorio

      The OAuth client id.

    • namestringobbligatorio

      The app's name.

  • tenantobjectobbligatorio

    The restaurant this token belongs to.

    Campi interni (6)
    • idstring (uuid)obbligatorio

      The restaurant's id (tenant_id in events).

    • namestringobbligatorio

      The restaurant's name.

    • slugstringobbligatorio

      Its address: <slug>.flavoso.com.

    • timezonestringobbligatorio

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

    • currencystringobbligatorio

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

    • countrystringobbligatoriopuò essere 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[]obbligatorio

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

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

  • planstringobbligatorio

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

    Valori:"starter""pro""premium"

  • rate_limitobjectobbligatorio

    The rate limit of this connection.

    Campi interni (2)
    • limitintegerobbligatorio

      Requests per window.

    • window_secondsintegerobbligatorio

      Window length in seconds.

  • created_atstring (date-time)obbligatorio

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

Errori

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

Tutti i codici di errore

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

Permesso:
qualsiasi token valido
Piano:
tutti i piani

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.

Risposta200

OK

  • objectstringobbligatorio

    Always connection.

    Valori:"connection"

  • idstring (uuid)obbligatorio

    The connection that ended.

  • revokedbooleanobbligatorio

    Always true.

    Valori:true

Errori

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

Tutti i codici di errore

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

Qualcosa non è chiaro? Scrivi a support@flavoso.com indicando l'identificativo di X-Request-Id. Così troviamo la tua richiesta nel registro.