Saltar al contenido

API · En preparación

La API de WAT: tus reservas, en tus sistemas.

Leer reservas, clientes, conductores y vehículos desde tu sistema, y enterarte de cada cambio por webhooks firmados. Está en preparación: se activa bajo petición, cuenta a cuenta. La referencia técnica está en la documentación para desarrolladores y el contrato, en openapi.yaml.

El problema

Los datos de tus traslados no deberían vivir en una isla

  • Tu cliente corporativo quiere ver sus reservas en su sistema.
  • Tu contable copia reservas a mano a otra herramienta.
  • Tu PMS necesita saber cuándo se ha completado un traslado.

Cómo lo resuelve WAT

Leer y escuchar, con permisos por clave

  1. Nos pides una claveCon los permisos justos (scopes). La emite nuestro equipo y solo abre los datos de tu empresa.
  2. Lees lo que necesitasListados paginados por cursor y la ficha de cada recurso, en JSON.
  3. Te suscribes a los cambiosDas de alta un webhook y recibes cada cambio de una reserva, firmado.

Qué hace hoy

Qué ofrecerá la API v1

Hoy no está abierta: la activamos bajo petición, con permisos por clave.

  • Reservas, clientes, conductores y vehículos

    Disponible

    Listados y fichas de solo lectura, siempre acotados a tu empresa.

  • Eventos

    Disponible

    El historial de lo que le ha pasado a cada reserva.

  • Identificadores externos

    Disponible

    Guarda en cada reserva el identificador de tu sistema para reconciliar los dos.

  • Webhooks firmados

    Disponible

    Ocho eventos de reserva: creada, actualizada, asignada, empezada, completada, cancelada, no presentada y borrada.

  • Reintentos y rotación del secreto

    Disponible

    Si tu servidor no responde, se reintenta con espera creciente. El secreto se rota sin cortar la recepción.

  • Permisos por clave

    Disponible

    Cada clave abre solo lo que se le concede. Límites de peticiones por clave y por empresa.

  • Idempotencia y paginación por cursor

    Disponible

    Repetir una escritura no la duplica; recorrer un listado largo no salta filas.

  • Contrato OpenAPI público

    Disponible

    Para generar tu cliente en cualquier lenguaje.

  • Crear o modificar reservas

    Planificada

    Previsto, no implementado en v1. Para que entren reservas desde fuera están el motor, el portal y el Excel.

Cómo se empieza hoy

Una clave, pedida a una persona

Las claves las emite nuestro equipo una a una, con los permisos que necesite tu integración.

Escríbenos con qué sistema quieres conectar y qué necesitas leer o escuchar. Te respondemos con los permisos concretos y, si algo no se puede hoy, te lo decimos.

Lo que nos preguntan

¿Puedo usar la API ya?

Está en preparación y se activa bajo petición, cuenta a cuenta. Escríbenos con qué sistema quieres conectar y lo vemos con tu caso.

¿La API es de pago?

Está incluida en el plan único. No hay tarifa aparte por usar la API.

¿Qué datos puedo leer?

Reservas (las que origina o ejecuta tu empresa), clientes, conductores, vehículos y los eventos de cada reserva. Siempre de tu empresa: la clave decide la organización y ningún parámetro la cambia.

¿Puedo crear reservas desde mi sistema?

La v1 es de lectura sobre las reservas. Para que entren reservas desde fuera están el motor, el portal del cliente y la carga masiva desde Excel.

¿Qué permisos y entornos hay?

Cada permiso y su estado, el entorno disponible y la versión están en la documentación para desarrolladores, que es la referencia técnica al día.

¿Cómo sé que un webhook es de WAT?

Cada entrega va firmada con el secreto de tu webhook y lleva marca de tiempo para rechazar repeticiones. La verificación está en la documentación.

¿Hay límites de peticiones?

Sí, por clave, por empresa y por ruta. Las cifras exactas y las cabeceras que las indican están en la documentación de límites.

Cuéntanos qué quieres conectar.

Te decimos qué permisos necesitas y, si algo no se puede hoy, también.

Habla por WhatsApp