Ir al contenido

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.

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
Ventana de terminal
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

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.

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