Empezar

Entornos de la API

Hoy la WAT API tiene un solo servidor: live. Las claves llevan el entorno en el nombre y la comprobación existe, pero no hay ningún servidor de pruebas al que apuntar.

Entorno	Clave	Servidor	Estado
live	`wat_live_…`	`https://wearetransfers.com/api/v1`	El único que hay. Datos reales de tu empresa.
test	`wat_test_…`	—	Sin servidor público. Una clave de test no abre en ningún sitio.

No pidas una clave de test

El prefijo wat_test_ existe en el formato de las claves y el servidor lo comprueba, pero no hay ningún despliegue de la WAT API en entorno test al que puedas llamar. Una clave wat_test_ contra wearetransfers.com responde 401 wrong_environment, siempre. Integra con una clave wat_live_ de solo lectura, como se explica en Cómo probar hoy.

Qué es la comprobación de entorno

Cada despliegue de la API es de un solo entorno y lo lleva fijado. Una clave del otro entorno no abre, exista o no el servidor contrario:

json

{
  "error": {
    "code": "wrong_environment",
    "message": "Esta clave es de test y este servidor es live",
    "request_id": "req_9f8e7d6c5b4a39281706"
  }
}

Es un 401: se comprueba por el prefijo, antes de buscar la clave en la base, así que ni siquiera consume el registro de la integración. Cuenta como fallo de autenticación para el límite por IP.

Cómo probar hoy

Esto es lo que de verdad tienes para desarrollar e integrar, y es suficiente para montar un ERP entero contra la v1:

Una clave wat_live_ de solo lectura con los scopes mínimos. La v1 es de solo lectura sobre el dominio (reservas, clientes, conductores, vehículos, eventos): leer no cambia nada, ni mueve dinero, ni avisa a nadie.
Una integración aparte —llámala «ERP · pruebas»— para las dos escrituras que sí existen (identificadores externos y webhooks). Tiene sus propios scopes, su propia clave y se puede desactivar o borrar sin tocar la integración de producción.
POST /v1/webhooks/{id}/test para los webhooks: entrega un evento webhook.test real, firmado igual que los demás, sin tocar ninguna reserva. Ver Probar webhooks.
Un identificador externo de usar y tirar: PUT y DELETE sobre /bookings/{id}/external-id son reversibles y no afectan a nada más.

Lo que no puedes hacer

No hay forma de crear reservas de mentira para probar: la v1 no crea reservas (ver changelog), así que los datos con los que integras son los que tu empresa ya tiene en We Are Transfers. Si necesitas datos inventados, créalos desde el panel en las reservas de tu propia cuenta y bórralos al terminar.