API para desarrolladores
| Por qué | Dar al desarrollador del hotel — o al integrador — un punto de partida: qué es el API, dónde vive su especificación y cómo funciona el acceso. |
| Para quién | Al desarrollador que conecta su propio sistema a HotelsCalendar; al propietario, para enseñárselo a un contratista. |
| Qué obtendrás | La imagen clara de la superficie del API — qué datos puede traer — y del proceso de acceso: un token y una URL base. |
| Limitaciones | Esto es un punto de partida, no una referencia de métodos: la lista completa vive en la especificación, y los límites técnicos no se publican. |
HotelsCalendar tiene un API: las mismas reservas, la disponibilidad y los huéspedes con los que trabajas en la interfaz — por programa. Esta página es el punto de partida: qué es esta interfaz, dónde vive su especificación y cómo conseguir acceso. Aquí no hay ejemplos con código — su lugar lo ocupa la especificación.
Qué es el API de HotelsCalendar
Sección titulada «Qué es el API de HotelsCalendar»El API es una interfaz de programación sobre el producto. Sirve y acepta los mismos datos que la interfaz del PMS: reservas, disponibilidad, huéspedes. La interfaz es para personas; el API, para programas: un sistema de contabilidad, un script o una hoja de cálculo lee y actualiza los datos del hotel sin trasvase manual.
Los datos hablan el mismo idioma que los artículos de esta documentación: reservas con estados y huéspedes, disponibilidad por fechas, datos de los huéspedes. Por eso cualquier integración empieza por entender cómo describe el producto esas entidades.
La especificación
Sección titulada «La especificación»La descripción completa del API es su especificación OpenAPI, el archivo openapi.yaml: enumera todos los métodos — qué acepta y qué devuelve cada uno — y los modelos de datos. La especificación está agrupada en unas 24 secciones temáticas.
La especificación se abre y se descarga por la URL base del API — la dirección que se entrega junto con el acceso. Es la fuente de verdad sobre las capacidades: todo lo que describe, el API lo sabe hacer; lo que no figura en ella, el API no lo promete.
Autorización
Sección titulada «Autorización»El acceso al API va por token: una clave personal que viaja con cada petición. Por el token el API sabe de qué alojamiento viene la petición y qué tiene permitido ese acceso.
El token y la URL base llegan juntos, al configurar el acceso (cómo pedirlo, más abajo). Trata el token como una contraseña: abre los datos del alojamiento, así que se guarda en tu lado y no se publica.
Escenarios típicos
Sección titulada «Escenarios típicos»- Tu propia analítica. Las reservas se exportan a tu herramienta de BI o a una hoja de cálculo, y allí se calculan como necesitas — sin exportación manual cada mes.
- Sincronización con sistemas internos. El programa de contabilidad o el servicio interno del hotel recibe las reservas y los cambios del PMS — y los datos no se separan entre sistemas.
- Mini-servicios y widgets. Una herramienta ligera sobre los datos del hotel — una página interna para el personal, un resumen para el gestor — que lee del PMS directamente.
Los tres escenarios siguen el mismo camino: conseguir el token, encontrar los métodos necesarios en la especificación y conectar tu sistema.
Qué no hay
Sección titulada «Qué no hay»- Los límites técnicos del API — frecuencia de peticiones, tamaño de las exportaciones — no se publican en este artículo.
- La lista de capacidades es solo la especificación: los métodos y los modelos los describe openapi.yaml, y el artículo no promete nada más allá.
- Cómo evoluciona el API con el tiempo — la compatibilidad de versiones, cómo se avisa de los cambios — tampoco lo promete esta página: las condiciones se hablan al configurar el acceso.
- Aquí tampoco hay tutoriales paso a paso con código — ese papel lo cumple la especificación.
Cómo conseguir el acceso
Sección titulada «Cómo conseguir el acceso»- Escríbenos desde la página «Contactos» de la web de HotelsCalendar: cuenta tu tarea — qué sistema se conecta y qué datos necesita.
- Te enviaremos un token y la URL base del API.
- A partir de ahí, con la especificación: encuentra los métodos que encajen con tu tarea y conecta tu sistema.
Si tu pregunta no va de desarrollo, sino de la gestión del hotel — empieza por la página de soporte.
Véase también
Sección titulada «Véase también»- Soporte y contacto — dónde y cómo escribir al equipo: el acceso al API también empieza ahí.
- Glosario de términos hoteleros — en claro, los términos hoteleros que aparecerán en los datos: reserva, disponibilidad, tarifa, check-in.