Desarrolladores

Una API REST limpia para disponibilidad y reservas.

Lee la disponibilidad en vivo y crea reservas para tus propios restaurantes de forma programática. Autentícate con un único token bearer, recibe JSON y conecta Tablevent con el resto de tu stack.

Crear una clave de API

Autenticación

Cada solicitud se autentica con una clave de API que generas tú mismo. Las claves están limitadas a tu organización y solo a los restaurantes que posees. Envía tu clave como token bearer en la cabecera Authorization — las claves se muestran una vez y solo se almacenan como hash, así que guarda la tuya de forma segura.

1Inicia sesión y abre API keys en tu panel de gestión.
2Crea una clave — copia el secreto tvk_… mostrado una sola vez.
3Envíalo como token bearer en cada solicitud.

Crear una clave de API

Cabecera Authorization

Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URL base

Todos los endpoints se sirven por HTTPS desde un único host. Las respuestas son JSON; los errores devuelven un cuerpo JSON con un campo error y un estado HTTP correspondiente (401 no autorizado, 404 no encontrado, 409 conflicto, 429 límite de tasa).

https://tablevent.com

Endpoints

La API pública es deliberadamente pequeña y estable. Esto es todo lo disponible hoy — vienen más endpoints.

GET/api/v1/availability

Devuelve las franjas reservables de uno de tus restaurantes para una fecha y un tamaño de grupo dados. Parámetros: slug, date (AAAA-MM-DD) y party.

Solicitud de ejemplo

curl "https://tablevent.com/api/v1/availability?slug=your-restaurant&date=2026-07-01&party=2" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET/api/v1/bookings

Lista las reservas más recientes de tu organización (últimos 30 días) en todos tus restaurantes, las más nuevas primero.

Solicitud de ejemplo

curl "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

POST/api/v1/bookings

Crea una reserva confirmada. Revisa la disponibilidad en vivo bajo bloqueo, para que nunca puedas sobrerreservar la última mesa. Devuelve el id de la nueva reserva.

Solicitud de ejemplo

curl -X POST "https://tablevent.com/api/v1/bookings" \
  -H "Authorization: Bearer tvk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "your-restaurant",
    "startsAt": "2026-07-01T19:00:00.000Z",
    "partySize": 2,
    "name": "Ada Lovelace",
    "email": "[email protected]"
  }'

Límites de tasa

Los límites se aplican por organización mediante un token bucket. Superar un límite devuelve un HTTP 429 — espera y reintenta.

Lecturas (disponibilidad, listar reservas): Ráfaga de 120, recargando 2 solicitudes/segundo
Escrituras (crear reserva): Ráfaga de 30, recargando 1 solicitud cada 2 segundos

¿Listo para crear?

Genera una clave en tu panel y haz tu primera llamada en minutos. ¿Necesitas un endpoint que aún no listamos? Dinos qué estás construyendo.

Crear una clave de API Habla con nosotros