Cloudbeds API

 La API de Cloudbeds es tu vía para ampliar la plataforma, no para sustituir partes de ella. Te da acceso abierto y bidireccional al mismo modelo de datos que hace funcionar Cloudbeds: un único perfil de huésped, una única reserva, un único libro de contabilidad. Nuestros servicios más recientes, Contabilidad, Perfil del huésped, Perfil de grupo y Etiquetado de atributos, están construidos REST-first, y toda la plataforma está documentada sobre HTTP con soporte de GraphQL para consultas flexibles. No estás añadiendo un parche. Estás construyendo directamente sobre el sistema de registro.

Cualquier cosa que responda a un flujo de trabajo real: un motor de reservas propio para tu web, app o kiosco; sincronización con TPV y back-office para que los cargos se registren automáticamente; automatización del recorrido del huésped activada por eventos de reserva en tiempo real; envío de tarifas desde tu RMS; o un desarrollo que funcione en toda tu cartera con un único conjunto de credenciales. Si estás creando algo para todo el sector y no solo para tus propios alojamientos, también puedes empaquetarlo y publicarlo en el Marketplace de Cloudbeds, frente a más de 20.000 alojamientos en más de 150 países.

El 100 % de los endpoints están disponibles en seis áreas: Operaciones y reservas, Pagos, Distribución, Huésped, Webhooks y eventos, e Identidad y acceso. Como hay un único modelo de datos detrás de todo, siempre lees y escribes los mismos registros de huésped, reserva y contabilidad que usa el resto de la plataforma, no una copia aparte que haya que reconciliar después.

Sí. Los webhooks permiten que tu integración reaccione en el momento en que algo cambia en Cloudbeds —una nueva reserva, una actualización de tarifa, el check-in de un huésped— en lugar de hacer sondeos o esperar a una sincronización por lotes. Combinado con GraphQL, también puedes consultar exactamente los datos que necesitas en una sola llamada, en lugar de reunirlos desde varios endpoints.

Sí, eso forma parte esencial del diseño, no es una solución alternativa. La API a nivel de grupo te da un único conjunto de credenciales para uno, varios o todos los alojamientos de un portfolio, de modo que los equipos de IT y las cadenas puedan estandarizar el acceso y la gobernanza en lugar de gestionar claves independientes por alojamiento.

Seis pasos: encuentra la API adecuada para tu caso de uso en la referencia y las guías; importa la colección pública de Postman o genera credenciales de sandbox en api.cloudbeds-stage.com para empezar a probar de inmediato; autentícate mediante OAuth 2.0; solicita credenciales de producción con el alcance necesario; pasa por la certificación si estás desarrollando para otros hoteleros o para el marketplace; y ponlo en marcha, ya sea para tus propios alojamientos o para toda la red de Cloudbeds.

Sí. api.cloudbeds-stage.com es un entorno de staging completo que refleja producción, así que puedes construir y probar sin tocar un alojamiento en activo. También hay disponible una colección pública de Postman, por si prefieres empezar a hacer llamadas antes que leer la documentación de referencia.

Sí: los límites se publican por conjunto de credenciales, y las respuestas de la API incluyen cabeceras que muestran tu cuota restante, así que puedes construir la lógica de reintento y espera sobre límites conocidos y no sobre conjeturas.