Volver al blog

Software para parques de vacaciones API-first: Tillor como plataforma headless

Construya sobre infraestructura headless con OpenAPI, webhooks y eventos en tiempo real. CRUD completo en entidades principales; ampliamos la API donde su integración lo necesite.

API
OpenAPI
Webhooks
Integraciones
Software para parques de vacaciones API-first: Tillor como plataforma headless

Una API es la forma en que otro programa habla con Tillor: su web, paquete contable o app propia pueden leer reservas y facturas sin abrir el escritorio Tillor. OpenAPI es la lista oficial de lo disponible; los webhooks son señales automáticas cuando ocurre algo, por ejemplo factura pagada.

Los parques de vacaciones rara vez funcionan con un solo paquete estándar. Tiene CRM, software contable, su propia web y, a veces, hardware en el terreno. Como software para parques de vacaciones, Tillor debe ser el backend de esa pila: la app web es un cliente más sobre la misma API que usan los integradores.

Queremos que construya flujos sin atajos. Cada endpoint de organización está publicado en OpenAPI, ofrecemos webhooks y SSE para eventos, y soportamos MQTT donde pub/sub encaja mejor. ¿Falta algo para una integración seria? Hable con nosotros: CRUD completo en entidades principales es la base, y podemos ampliar endpoints cuando su caso lo justifique.

🔌 OpenAPI es la fuente de verdad

Cada endpoint de organización está en la especificación OpenAPI y puede probarse en la referencia de la API. Listar, leer, crear, actualizar y eliminar clientes, ocupaciones, facturas, productos, contadores y tareas están disponibles hoy; la especificación muestra exactamente qué métodos están activos por recurso.

Copiar enlace a esta secciónEscenarios para integradores

Su propio widget de reservas. Su sitio envía reservas directamente a Tillor, lee disponibilidad con endpoints de listado y envía el correo de confirmación desde su stack. Tillor sigue siendo la fuente de ocupaciones y facturación.

Data warehouse o BI. Trabajos nocturnos extraen clientes, facturas abiertas y lecturas de contadores con llamadas paginadas. Sin CSV obsoleto; lee los mismos campos que recepción.

Acoplamiento orientado a eventos. En factura pagada o cliente creado, un webhook activa su middleware. ¿Prefiere un flujo abierto? SSE entrega las mismas claves de evento en vivo.

Hardware en el terreno. Barreras, impresoras y lectores de identidad hablan en local a través del Connector; su integración en la nube sigue en HTTP y eventos.

Copiar enlace a esta secciónCRUD en entidades principales

Para cada entidad base en Tillor el objetivo es claro: debe poder listar, leer, crear, actualizar y eliminar registros por HTTP sin abrir la interfaz.

En la práctica, por ruta de org bajo /api/orgs/{orgId}/...:

AcciónMétodo HTTP típico
Listar (paginación y filtros)GET en la colección
LeerGET en {id}
CrearPOST
ActualizarPATCH o PUT (parcial vs reemplazo completo, según entidad en OpenAPI)
EliminarDELETE

Hoy clientes, ocupaciones, facturas, productos, contadores y tareas siguen ese patrón. Reservas y terrenos van en la misma dirección; consulte OpenAPI para el conjunto de métodos actual por recurso.

Las acciones de flujo (check-in, contabilizar factura, prolongar estancia) tienen un endpoint explícito en lugar de una acción oculta en pantalla. Su integración se mantiene estable cuando evoluciona la interfaz.

Copiar enlace a esta secciónFlexibilidad y ampliación

Tillor no es una isla cerrada. Queremos que los partners encajen Tillor en paisajes existentes:

  • REST estándar con entrada y salida esquematizadas con Zod en OpenAPI
  • URLs por organización y cabeceras (x-api-key, X-Tillor-Org-Id) según HTTP API
  • Límites de tasa planificables (5000 peticiones por 60 segundos por clave)
  • Los mismos eventos vía webhook, SSE o MQTT, lo que mejor maneje su stack

¿Necesita un filtro de listado extra, acción masiva o delete que falta para una acoplamiento? Bajo petición acordamos ampliaciones de API cuando encajan en el modelo de datos y benefician a otros clientes. Sin one-offs secretos: los nuevos endpoints llegan a OpenAPI para que todos los usen.

Copiar enlace a esta secciónVentajas para su proyecto

  • Un contrato: OpenAPI + referencia de la API, sin ingeniería inversa de la interfaz
  • Plataforma headless: Tillor como backend de su front-end, portal o app móvil
  • Eventos incluidos: omita polling cuando webhook o SSE basten
  • Local + nube: Connector para hardware on-prem, API para sistemas centrales
  • Docs para IA y codegen: documentación para desarrolladores y llms-full.txt para herramientas

Copiar enlace a esta secciónCómo se ve para integradores

Toda integración empieza con una clave API: abra el menú de usuario (resaltado 1) y vaya a API keys (resaltado 2).

Autenticación, cabeceras de org, límites de tasa, webhooks y ejemplos de código están en HTTP API, Webhooks y Ejemplos. Pruebe endpoints en la referencia de la API o vía OpenAPI.


¿Construye sobre Tillor? Solicite una demo y revisamos OpenAPI, eventos y su caso de uso juntos.