ConsolaIr a la web

API de FlavosoReferencia de la APIConexión

Conexión

La conexión entre tu app y un negocio. GET /me es la primera llamada de toda integración: qué negocio, qué permisos, prueba o real (livemode), qué plan. DELETE /connection termina la conexión desde tu lado.

Endpoints

Retrieve the connection, its app and its restaurant

get/me

Permiso:
cualquier token válido
Plan:
todos los planes

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

Respuesta200

OK

  • objectstringobligatorio

    Always connection.

    Valores:"connection"

  • idstring (uuid)obligatorio

    The connection, also connection_id in events.

  • livemodebooleanobligatorio

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

  • appobjectobligatorio

    Your app.

    Campos anidados (2)
    • client_idstringobligatorio

      The OAuth client id.

    • namestringobligatorio

      The app's name.

  • tenantobjectobligatorio

    The restaurant this token belongs to.

    Campos anidados (6)
    • idstring (uuid)obligatorio

      The restaurant's id (tenant_id in events).

    • namestringobligatorio

      The restaurant's name.

    • slugstringobligatorio

      Its address: <slug>.flavoso.com.

    • timezonestringobligatorio

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

    • currencystringobligatorio

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

    • countrystringobligatoriopuede ser 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[]obligatorio

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

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

  • planstringobligatorio

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

    Valores:"starter""pro""premium"

  • rate_limitobjectobligatorio

    The rate limit of this connection.

    Campos anidados (2)
    • limitintegerobligatorio

      Requests per window.

    • window_secondsintegerobligatorio

      Window length in seconds.

  • created_atstring (date-time)obligatorio

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

Errores

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

Todos los códigos de error

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

Permiso:
cualquier token válido
Plan:
todos los planes

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.

Respuesta200

OK

  • objectstringobligatorio

    Always connection.

    Valores:"connection"

  • idstring (uuid)obligatorio

    The connection that ended.

  • revokedbooleanobligatorio

    Always true.

    Valores:true

Errores

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

Todos los códigos de error

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

¿Algo no ha quedado claro? Escribe a support@flavoso.com e indica el identificador de X-Request-Id. Así podremos encontrar tu solicitud en el registro.