Saltar al contenido
API

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

Lee reservas, clientes, conductores y vehículos desde tu ERP, tu PMS o tu herramienta de informes, y entérate de cada cambio por webhooks firmados. 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é ofrece la API v1

  • 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

Mientras la API está en rodaje, las claves las emite nuestro equipo una a una desde la consola de administración, con los permisos que necesite tu integración. No hay botón de «crear clave» en el panel ni entorno de pruebas público, y preferimos decirlo a enseñarte uno que no existe.

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.

Sin letra pequeña

Lo que todavía no hace

  • Crear, modificar o cancelar reservas por APILa v1 es de lectura sobre las reservas.
  • Autoservicio de clavesLas emite nuestro equipo.
  • Entorno de pruebas públicoSolo existe producción. Las claves de prueba no abren ningún entorno hoy.
  • SDK oficialNo hay librerías propias: el contrato OpenAPI sirve para generarlas.
  • Facturas, cobros y posición del vehículo por APIEstán previstos en los permisos, pero no implementados en v1.
Preguntas frecuentes

Lo que nos preguntan

¿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?

Hoy no. Está previsto, pero la v1 no lo implementa. Mientras, las reservas entran por el motor, el portal del cliente o la carga masiva desde Excel.

¿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.

¿Hay entorno de pruebas?

No hay uno público. Si necesitas probar, escríbenos y lo vemos con tu caso.

Sigue por aquí

Cuéntanos qué quieres conectar.

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

Habla por WhatsApp