Para desarrolladores

La API de Flavoso

Pedidos, carta, horarios de apertura, reservas y ventas de un restaurante, mediante REST y webhooks. La conexión se hace con OAuth 2.0, con el consentimiento del propietario.

Cuenta de desarrollador gratuita Inicio rápido Referencia de la API

Sin negocio propio y sin suscripción. Incluye un negocio de prueba con datos.

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

Qué puedes construir

Una app trabaja en nombre de un negocio, con los permisos exactos que ha aceptado su propietario. Algunos ejemplos:

Sistemas de cajaLos pedidos llegan a la caja, que se hace cargo de ellos con su propio número de ticket. La caja mantiene la carta, los precios y los platos agotados, y por la noche concilia las ventas.Software de repartoHacerse cargo de los pedidos a domicilio con dirección y hora deseada, comunicar el estado y pausar los pedidos online en las horas de más trabajo.ContabilidadConsultar las ventas por día, tipo impositivo, método de pago y tipo de pedido, con las mismas reglas que las cifras del panel.ReservasConsultar horas libres, reservar mesas, confirmar reservas y sentar a los clientes.AutomatizaciónReaccionar a eventos: pedido nuevo, cambio de estado, agotado, pausa. Firmados, con reintentos y registro.

Cómo funciona

Tu app llama a la API REST en https://api.flavoso.com/v1. Cada solicitud lleva un token de acceso, y cada token pertenece a una sola conexión entre tu app y un negocio.

Una conexión se crea cuando un propietario da su consentimiento a tu app (OAuth 2.0 con PKCE). Lo que cambia en el negocio, Flavoso lo comunica a tu servidor por webhook; una caja sin dirección pública recoge los mismos eventos con GET /events.

Tu app

Caja, reparto, contabilidad, sistema propio

API de Flavoso

REST en api.flavoso.com/v1

Negocio

Página de pedidos, cocina, panel, app móvil

1
Conectar
El propietario da su consentimiento a tu app (OAuth 2.0). Tu app recibe tokens solo para ese negocio.
2
Solicitudes
Tu app lee y escribe con el token: pedidos, carta, horarios, reservas, ventas.
3
Eventos
Flavoso notifica cada cambio a tu servidor por webhook, o tu app los recoge con GET /events.

Cinco pasos hasta tu primera integración

1
Crear una cuenta
Basta una cuenta gratuita de Flavoso, sin negocio y sin suscripción.
2
Crear una app y un negocio de prueba
En la consola te guía el asistente de configuración: nombre, lugar de ejecución y permisos de la app, y después el negocio de prueba con carta, mesas y herramientas.
Consola
3
Obtener un token de prueba y hacer solicitudes
Un clic en Credenciales, después GET /me y GET /orders. Listo en dos minutos.
4
Integrar OAuth y webhooks
Así es como cada negocio conectará tu app más adelante, con los eventos enviados a tu servidor.
5
Enviar a revisión
Una vez aprobada, cualquier negocio puede conectar tu app y, si quieres, aparece en el directorio de apps.