Primeros pasos

Errores

Los errores usan códigos de estado HTTP estándar y un cuerpo JSON coherente.

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No data found for this request. You were not charged.",
    "request_id": "req_k3J9xQ2mT0aB"
  }
}

Registra siempre el request_id. También está en el encabezado x-request-id y permite al soporte encontrar tu solicitud exacta.

Estado	Código	Significado	Se cobra
400	missing_parameter / invalid_parameter / invalid_request	Falta un parámetro o está mal formado, por ejemplo un VIN que no tiene 17 caracteres válidos.	No
401	missing_api_key / invalid_api_key	No se envió ninguna clave, o la clave es incorrecta o está revocada.	No
402	insufficient_credits	Tu saldo de créditos no cubre esta solicitud.	No
403	account_suspended	La cuenta está suspendida. Contacta con soporte.	No
404	not_found / endpoint_not_found	No existen datos para esta consulta, o la ruta no existe.	No
429	rate_limited	Demasiadas solicitudes. Respeta el encabezado retry-after.	No
502	upstream_error / upstream_unreachable	Nuestro proveedor de datos devolvió un error. Se puede reintentar.	No
503	maintenance	Mantenimiento programado. Reintenta después del tiempo indicado en retry-after.	No
504	upstream_timeout	Nuestro proveedor de datos tardó demasiado. Se puede reintentar.	No

Cómo gestionar los fallos

Considera 4xx un problema de la solicitud. No la reintentes sin cambios, salvo 429.
Reintenta 502, 503 y 504 con espera exponencial. No se te cobran los intentos fallidos.
Establece un tiempo de espera del cliente de al menos 30 segundos; algunas consultas dependen de fuentes externas más lentas.