Sección 8 de 12

Integraciones y API

Integra Buqq con tu POS o herramientas personalizadas a través de la API REST externa.

La sección de Integraciones proporciona una API REST externa para crear integraciones personalizadas con su POS u otras herramientas. Acceda desde Panel de control → Integraciones.

La referencia completa de la API — esquemas de endpoints, detalles de autenticación y ejemplos — está disponible en buqq.online/api-docs.
Las alertas de reservas por Telegram se configuran en Configuración → Notificaciones. Consulte la sección Configuración de esta guía para los pasos de configuración.

ID de comerciante#

Su ID de comerciante es un identificador único para su cuenta dentro de la plataforma Buqq. Se muestra en la página de Integraciones y es necesario al contactar con soporte o al usar ciertos endpoints de la API.

Claves de API#

La API externa de Buqq le permite consultar disponibilidad, crear reservas y actualizar estados de reservas desde sus propios sistemas. El acceso a la API requiere una clave de API asociada a su cuenta de comerciante.

Generar una clave

  1. En Panel de control → Integraciones, desplácese hasta "Claves de API".
  2. Haga clic en "Generar clave de API".
  3. Copie la clave y guárdela en sus variables de entorno o gestor de secretos.
Trate su clave de API como una contraseña — no la comparta ni la incluya en el control de versiones. Si sospecha que una clave ha sido comprometida, revóquela inmediatamente y genere una nueva.

Revelar la clave actual

Si necesita recuperar su clave existente, haga clic en Revelar — la clave completa se muestra para que pueda copiarla de nuevo.

Rotar una clave

La rotación reemplaza su clave actual por una nueva. La clave anterior se invalida inmediatamente. Actualice cualquier integración que use la clave anterior antes de rotar.

Revocar una clave

La revocación elimina la clave actual sin emitir una nueva. Las llamadas a la API fallarán hasta que genere una nueva clave. Use la revocación si sospecha que una clave ha sido comprometida.

Fragmentos cURL#

La página de Integraciones muestra fragmentos cURL listos para usar para las operaciones más comunes de la API. Reemplace YOUR_API_KEY con su clave real para probar inmediatamente.

EJEMPLO — Consultar disponibilidad

curl https://buqq.online/api/external/v1/availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G -d "date=2025-08-15" -d "party_size=2"

Notas sobre POS#

Si está conectando Buqq a un sistema de punto de venta, la API externa soporta la lectura de las reservas confirmadas del día y la actualización de estados (p. ej. marcar una reserva como registrada o cancelada) desde su POS. Consulte la documentación de su proveedor de POS para los pasos de integración específicos, y consulte la documentación de la API para detalles de los endpoints.

GET /api/external/v1/availability
Devuelve las franjas disponibles para una fecha y tamaño de grupo dados.
GET /api/external/v1/bookings
Lista las reservas de su restaurante. Filtre por fecha.
POST /api/external/v1/bookings
Crea una nueva reserva programáticamente.
PATCH /api/external/v1/bookings/{id}/status
Actualiza el estado de una reserva (confirmed, checked_in, cancelled, no_show).