Primeros pasos

Errores

Gestiona los errores según el estado HTTP y nunca reintentes a ciegas cada solicitud fallida. Envía siempre Accept: application/json.

EstadoQué hacer

400Parámetro no válido o límite de tamaño de página. Corrige la solicitud; no la repitas sin cambios.

401 / 403Clave ausente, no válida, caducada o inactiva, o acceso a la fuente denegado. Revisa la respuesta y la suscripción; no repitas sin cambios.

404Vehículo o lote no encontrado. Muestra un resultado vacío; no inventes un precio.

429Límite de solicitudes alcanzado. Respeta Retry-After si viene; usa un backoff limitado y ten en cuenta el presupuesto de tu plan.

5xx / timeoutReintenta solo lecturas seguras, con un número limitado de intentos. Conserva el último checkpoint correcto y no registres claves ni respuestas completas en logs.

Errores de autenticación

403{ "error": "please add auth key in x-api-key header" }
403{ "error": "wrong api key" }
403{ "error": "your api subscription has expired" }
403{ "error": "your api subscription is not active" }

Lee la respuesta con seguridad

Las comprobaciones de la aplicación suelen devolver un objeto con error; los fallos del framework y del gateway usan message.
Un gateway, proxy o servidor web puede devolver HTML, texto plano o un cuerpo vacío aunque se haya pedido JSON.
Reintenta solo solicitudes GET seguras, con un presupuesto limitado y esperas crecientes. Conserva tu último punto de control correcto.