DIVISA API / PRODUCCIÓN
Errores, reintentos y caché
Conserva X-Request-Id para encontrar la solicitud en tu consola o reportar un problema. No registres Authorization ni la clave.
| HTTP | Acción |
|---|---|
| 400 | Corrige parámetros según OpenAPI; no reintentes el mismo error. |
| 401 | Revisa Bearer, revocación o vencimiento. No reintentes hasta corregir la clave. |
| 403 | Revisa permisos o suspensión. |
| 404 | Revisa el recurso y la ruta. Una colección vacía puede ser 200. |
| 429 | Respeta Retry-After. Las claves comparten cuota. |
| 500 / 502 / 503 / 504 | Reintenta solo lecturas idempotentes, con backoff, jitter y un máximo de intentos. |
ETag / If-None-Match
Guarda la representación junto con ETag. En la siguiente consulta de la misma URL y formato envía If-None-Match. Si recibes 304, utiliza tu cuerpo almacenado; no intentes leer JSON de una respuesta vacía. Conserva el nuevo request ID y revisa la vigencia de cada tasa. No compartas caché personalizada entre cuentas.
Respuesta parcial
Un array vacío no equivale a un fallo del servicio. Verifica filtros y cobertura. Si no hay una tasa utilizable, muestra “sin tasa disponible”; nunca reemplaces null por cero ni prolongues expiresAt.