Ejemplos con curl

Todos los ejemplos usan el entorno dev. Exporta la URL base una vez (cuando api.dev.lade.com.mx esté activo, cámbiala por esa):

export API="https://<api-id>.execute-api.us-east-1.amazonaws.com/dev"

1. Health check (sin auth)

curl "$API/ping"

2. Login y captura del token

export TOKEN=$(curl -s -X POST "$API/login" -H "Content-Type: application/json" -d '{"email":"usuario@ejemplo.com","password":"Password123!"}' | jq -r '.tokens.idToken')

3. Mi perfil y mis equipos

curl "$API/users/me" -H "Authorization: Bearer $TOKEN"
curl "$API/teams" -H "Authorization: Bearer $TOKEN"
export TEAM_ID="<uuid del equipo elegido>"

4. Crear un cliente

curl -X POST "$API/clients" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"teamId":"'$TEAM_ID'","name":"Transportes García SA","email":"contacto@garcia.mx","phone":"+525512345678"}'

5. Listar vehículos del equipo (query param)

curl "$API/vehicles?teamId=$TEAM_ID" -H "Authorization: Bearer $TOKEN"

6. Crear un viaje (con idempotencia)

curl -X POST "$API/trips" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Idempotency-Key: $(uuidgen)" -d '{"teamId":"'$TEAM_ID'","routeId":"<uuid>","vehicleId":"<uuid>","driverId":"<uuid>","scheduledDate":"2026-08-01"}'

Si el equipo agotó su plan, la respuesta es 402 con error: "TRIPS_LIMIT_REACHED".

7. Ver un error de validación

curl -s -X POST "$API/clients" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"teamId":"'$TEAM_ID'","name":""}'
# → 400 {"error":"Validation failed","details":[...]}

8. Ver un 403 de multi-tenancy

curl -s "$API/vehicles?teamId=00000000-0000-4000-8000-000000000000" -H "Authorization: Bearer $TOKEN"
# → 403: no eres miembro de ese equipo

Consejo

Con token expirado cualquier llamada devuelve 401 {"error":"Token Expired",...} — repite el paso 2. Los cuerpos exactos de cada endpoint están en la Referencia de la API.