Ya puedes construir directamente sobre Veridien. El mismo motor que mueve nuestros propios flujos de reserva está abierto para ti: un motor de reservas propio, una app móvil para huéspedes, una integración de fidelidad o cualquier automatización de back office.
Es una interfaz HTTP/JSON sin más. Te autenticas con una clave de API por establecimiento, envías y recibes JSON en snake_case, y te apoyas en códigos de estado estándar y en un único formato de error uniforme. Cada clave tiene sus ámbitos, así que solo puede hacer lo que le concedas, y únicamente en el establecimiento al que pertenece.
- Claves de API por establecimiento. Crea, acota y revoca claves en Ajustes → Claves de API. Las claves se muestran una sola vez y se guardan solo como hash.
- Acceso acotado. Doce ámbitos granulares (por ejemplo
availability:read,reservations:write,folio:write) protegen cada endpoint, incluido un ámbitoguests:read:piiaparte para los datos personales sensibles. - El ciclo de vida completo de la reserva. Busca disponibilidad, calcula el precio de una estancia con tarifas filtradas por visibilidad, registra o vincula un huésped, bloquea inventario, confirma una reserva pagada y añade cargos a la cuenta.
- Fidelidad. Consulta el saldo y el nivel de un huésped, canjea puntos y acumula automáticamente en las estancias confirmadas.
- Reintentos seguros. Las peticiones que modifican datos aceptan una
Idempotency-Key, así que un reintento de red nunca duplica una reserva ni un cobro. La confirmación de reserva es además idempotente sobre su referencia de pago. - Errores predecibles. Cada fallo devuelve un formato tipado con un
codeestable, unparamopcional y unrequest_id. - Esquema OpenAPI 3.1. Una descripción legible por máquina de cada endpoint se sirve en
/api/v1/openapi.jsonpara generar clientes tipados.
| Área | Qué puedes hacer |
|---|---|
| Catálogo | Leer el establecimiento, los tipos de habitación, la disponibilidad y las tarifas elegibles |
| Huéspedes | Registrar o vincular huéspedes, leer y actualizar perfiles, consultar fidelidad |
| Reservas | Bloquear inventario, confirmar reservas, listarlas y leerlas, cancelar |
| Cuentas | Leer la cuenta de una reserva y añadirle cargos |
| Fidelidad | Consultar saldos y niveles, canjear puntos |
La referencia completa, un inicio rápido y ejemplos para copiar y pegar están en la documentación de la API. La URL base es https://veridien.app/api/v1.