La API de ThinkReservations te permite extraer automáticamente algunos de los datos de tu propiedad desde ThinkReservations, para que los desarrolladores puedan crear informes personalizados o conectar ThinkReservations con herramientas externas.

Está disponible en todos los planes sin costo adicional, y puedes configurarla tú mismo. Este artículo explica qué puede hacer la API para que decidas si es la opción adecuada. Si ya decidiste continuar, consulta Creación y administración de claves de API para ver la configuración paso a paso.

Informes personalizados. Si quieres una métrica, un desglose o un formato que nuestros informes integrados no ofrecen, puedes extraer los datos de origen y crear exactamente el informe que necesitas.

Alimentar tus propios sistemas. Envía los datos de tus reservas a tu propia base de datos, hoja de cálculo, flujo de trabajo contable o a una herramienta de inteligencia de negocios como Power BI, Tableau, Looker o Google Data Studio.

Envío de datos en un solo sentido a otras herramientas. Extrae tus datos de ThinkReservations y entrégalos en otro lugar para tu propio uso.

Trabaja con un desarrollador con el que ya cuentas. Muchas propiedades ya trabajan con un desarrollador web o una agencia, o tienen un propietario o gerente con perfil técnico. La API pone el trabajo en sus manos y no en las tuyas.

La API es un punto de conexión para software, no una función con interfaz de usuario. No hay nada en qué hacer clic, nada que configurar más allá de crear una clave, y ningún informe esperando del otro lado. Alguien tiene que construir algo.

Esa persona debe sentirse cómoda escribiendo código y leyendo documentación técnica. Si no tienes a alguien en tu equipo, un desarrollador web, un contratista o una agencia con la que ya trabajes normalmente puede hacerlo. Nuestra documentación técnica completa es pública en developers.thinkreservations.com, así que puedes enviársela a un desarrollador antes de comprometerte con algo y dejar que te diga si lo que quieres es posible.

ThinkReservations no crea informes ni integraciones por ti, ni escribe ni mantiene tu código. Consulta Obtener ayuda más abajo para ver qué soporte sí ofrecemos.

Es de solo lectura, con una excepción. Los datos fluyen desde ThinkReservations hacia afuera. Lo único que la API puede cambiar en tu cuenta es la configuración de tus tarifas diarias: precios y reglas de disponibilidad. Todo lo demás es de solo lectura.

No puede crear, modificar ni cancelar reservas. No esperamos que esto cambie a corto ni a mediano plazo. Si tu objetivo depende de que otro sistema cree o actualice reservas en ThinkReservations, la API no te servirá.

No puede enviar datos hacia ThinkReservations. Aparte de las tarifas diarias, no se puede escribir nada. Antes de invertir tiempo de desarrollo, conviene preguntarte en qué dirección necesitan fluir tus datos: si la respuesta es "hacia ThinkReservations", es probable que la API no sea la herramienta adecuada.

No existe una exportación única de todo. Las solicitudes de reservas requieren un rango de fechas o de marcas de tiempo, y los resultados llegan en páginas. Un desarrollador que espere que una sola solicitud devuelva todo tu historial de reservas tendrá que recorrer los resultados página por página.

No cubre todo lo que hay en el PMS. La API cubre las áreas listadas arriba, no todas las funciones del sistema.

No es una sincronización en vivo. Más abajo encontrarás más información al respecto.

Tu integración solicita datos cuando esté programada para hacerlo; esto se llama sondeo (polling). Los datos que recibes son exactos al momento de la solicitud.

No hay webhooks ni notificaciones push, por lo que ThinkReservations no envía una alerta a tu integración cuando algo cambia. Si necesitas que los datos se mantengan razonablemente actualizados, tu desarrollador configurará solicitudes programadas con una frecuencia que tenga sentido para tu uso.

Nos gustaría agregar compatibilidad con webhooks en el futuro, pero no tenemos una fecha para compartir.

Los datos de contacto de los huéspedes requieren su propio permiso. Leer reservas no incluye automáticamente el nombre, correo electrónico, teléfono o dirección del huésped. Ese es un permiso aparte que eliges al crear tu clave. Sin él, las reservas igualmente se reciben y siguen incluyendo un ID de cliente, de modo que una integración puede saber qué reservas pertenecen al mismo huésped, pero ese ID por sí solo no contiene datos personales.

Recomendamos otorgarlo solo si tu integración realmente lo necesita. Si estás creando un informe de ocupación o de ingresos, casi seguro no necesita los correos electrónicos de los huéspedes. Otorgar menos permisos es una buena práctica.

No otorgar ese permiso reduce lo que se expone, pero no hace que tus datos sean anónimos. Cierta información relacionada con los huéspedes forma parte de la reserva misma y no del registro de contacto, por ejemplo los nombres de huéspedes adicionales, restricciones alimentarias, acomodaciones especiales, campos personalizados y nombres de clientes en las partidas. Cualquier clave que pueda leer reservas puede leer esa información. Podemos decirte exactamente qué datos expone cada permiso; si una configuración determinada cumple con tus obligaciones es una pregunta para tu propio asesor legal.

A través de la API no hay datos de tarjetas de pago disponibles. Las reservas incluyen totales financieros (depósitos, impuestos, comisiones de procesamiento, saldos e impuestos desglosados), pero ningún número de tarjeta, token ni instrumento de pago de ningún tipo.

Una vez que los datos salen de ThinkReservations, tú eres responsable de cuidarlos. Cuando emites una clave y los datos fluyen a tu propio sistema o al de tu desarrollador, la forma en que se almacenan, protegen y usan es tu responsabilidad. Vale la pena conversarlo con quien esté haciendo el desarrollo.

No. "Pública" describe nuestra documentación, no tus datos. Cualquiera puede leer nuestra documentación técnica, igual que cualquiera puede leer el manual de un producto, pero nada de tu cuenta es accesible sin una clave de API. Tú creas esa clave, solo da acceso a los datos de tu propia propiedad y puedes eliminarla cuando quieras.

Actualmente no hay límites publicados sobre la cantidad de datos que puedes solicitar. Sí esperamos introducir límites en el futuro para evitar abusos y proteger el rendimiento para todos. Conviene pedirle a tu desarrollador que construya su solución teniendo esto en cuenta.

Si tu desarrollador encuentra un comportamiento inesperado con un volumen alto de solicitudes, puede escribir a product@thinkreservations.com.

Trabajamos para hacer mejoras sin afectar las integraciones existentes. Si un cambio no se puede hacer sin romper algo, nuestro enfoque es versionar la API, avisar a los clientes afectados que se necesita una actualización y darles tiempo para hacerla, en lugar de cambiar sin aviso algo de lo que dependen las integraciones existentes.

Si tú o tu desarrollador creen haber encontrado un error, pídele que escriba a product@thinkreservations.com para crear un ticket con el equipo que puede ayudarte.

Lo que sí soportamos: la API y su documentación. Si algo falla de nuestra parte, lo corregiremos.

Lo que no soportamos: el código que escribes tú o tu desarrollador. No podemos depurar tu integración, crear tus informes ni mantener lo que hayas construido.

Si eres una empresa de tecnología que busca crear una integración que funcione con varias propiedades de ThinkReservations y no con una sola, ese es un camino distinto con un tipo de acceso diferente, y requiere una conversación con nuestro equipo de Producto.

Nuestra documentación para desarrolladores es pública y puedes leerla cuando quieras. Para hablar sobre una alianza o un listado en el Marketplace, escríbenos a product@thinkreservations.com, y te dirigiremos con la persona adecuada.

¿Tiene algún costo? No. El acceso a la API está incluido en todos los planes, sin cargo adicional y sin tarifas por uso por el momento. El único costo es el tiempo de desarrollo de tu lado.

¿Necesito tener algo activado? No. Está disponible en todos los planes y no hay nada que nosotros tengamos que activar. Tú creas las claves en Settings → API Keys. Si no puedes ver esa página, consulta Creación y administración de claves de API; normalmente se trata de un permiso de usuario.

¿Puedo probarla sin un desarrollador? Siendo realistas, no. No hay interfaz, así que hay que construir algo antes de ver resultados.

¿Ofrecen orientación o ayuda con preguntas técnicas? Nuestro equipo de soporte no podrá ayudarte a implementar tu clave de API, resolver problemas de tu proyecto ni dar soporte a tus socios de desarrollo. La documentación de la API creada por nuestro equipo de desarrollo es muy completa y será tu principal recurso para cualquier otra pregunta.

Nuestro soporte se limita a los siguientes recursos de documentación:

¿Puede mi desarrollador hacer pruebas sin afectar los datos reales? No con una Restricted API Key. No hay un entorno de pruebas separado para las claves de autoservicio, así que todo se ejecuta sobre tu cuenta real.

Leer datos es inofensivo. Actualizar las tarifas diarias no lo es: esos cambios son reales y surten efecto en tu cuenta. Pídele a tu desarrollador que tenga cuidado con esa parte y que haga pruebas.

¿Por qué los números de disponibilidad de la API no coinciden con mi calendario? Los resultados de disponibilidad dependen tanto de las fechas como de la ocupación indicada en la solicitud. Una solicitud con una ocupación distinta devolverá resultados distintos, así que esta suele ser la explicación; conviene comparar la ocupación de la solicitud de tu desarrollador con lo que ves en tu calendario.

¿Puedo obtener todo mi historial de reservas en una sola solicitud? No. Se requiere un rango de fechas o de marcas de tiempo, y los resultados están paginados, así que tu desarrollador tendrá que recorrerlos "página por página".

¿Es lo mismo que las integraciones de su Marketplace? No. Las integraciones del Marketplace se crean y mantienen en conjunto con ThinkReservations y funcionan para toda nuestra base de clientes. La API es para los datos de tu propia propiedad, construida por ti o por tu desarrollador.