Integraciones
Los sistemas de reservas, canales y servicios que conectaste a Bookline, sin su configuración.
Los endpoints de integraciones devuelven los sistemas de reservas, canales y servicios que conectaste a tu cuenta de Bookline. Devuelven qué es cada integración, nunca su configuración ni sus credenciales. Necesitan el permiso integrations:read.
| Endpoint | Ruta | Permiso |
|---|---|---|
| Listar integraciones | GET /v1/integrations |
integrations:read |
| Una integración | GET /v1/integrations/{integration_id} |
integrations:read |
Las integraciones son de todo el cliente: una clave limitada a algunos locales recibe 403 insufficient_scope. En los ejemplos, $BASE es https://api.bookline.ai/v1 y $BOOKLINE_API_KEY tu clave, como en los primeros pasos.
Listar integraciones
Sección titulada «Listar integraciones»GET /v1/integrations devuelve tus integraciones, paginadas.
| Parámetro | Tipo | Por defecto | Reglas |
|---|---|---|---|
limit |
de 1 a 100 | 50 | Integraciones por página |
cursor |
texto | ninguno | meta.next_cursor de la página anterior, con el mismo limit |
customer_id |
UUID | el cliente de la clave | Consulta qué lee cada clave |
curl -s -H "apikey: $BOOKLINE_API_KEY" "$BASE/integrations"{ "data": [ { "id": "…", "name": "CoverManager", "type": "COVERMANAGER", "category": "BACKEND", "created_at": "2026-02-11T09:30:00Z" } ], "meta": { "limit": 50, "next_cursor": null }}| Campo | Qué es |
|---|---|
id, name |
El identificador y el nombre de la integración |
type |
El sistema integrado, p. ej. COVERMANAGER, THE_FORK, OPENTABLE, MEWS_PMS, WHATSAPP_META; pueden aparecer otros |
category |
BACKEND: un sistema de reservas o de gestión hotelera; CHANNEL: un canal de conversación; SERVICE: cualquier otro servicio; NOT_AVAILABLE: sin clasificar |
created_at |
Cuándo se instaló la integración, o cuándo pasó a ser otra (ver abajo); null si no se conoce |
Una integración
Sección titulada «Una integración»GET /v1/integrations/{integration_id} devuelve los mismos campos. Una integración que no es de tu cliente, o que se eliminó, es 404 not_found.
Reglas de los datos
Sección titulada «Reglas de los datos»created_atindica desde cuándo la integración es la que es ahora. Cambiar su tipo o su id en el otro sistema (p. ej. el slug de CoverManager), o restaurarla después de eliminarla, la reinicia.- Sin configuración. Las claves de API, las contraseñas y el resto de la configuración nunca salen de Bookline.
- Las integraciones eliminadas no se listan ni se pueden leer por id.
- Solo lectura. Las integraciones se configuran en el portal.
Relacionado
Sección titulada «Relacionado»- Instalar una integración y plataformas de reservas: qué hace cada integración y cómo configurarla.
- Campañas:
integration_typeindica el sistema que lee una campaña.
