DIVISA API / PRODUCCIÓN
Errors, retries and caching
Keep X-Request-Id to locate a request in your console or report a problem. Never log Authorization or your key.
| HTTP | Action |
|---|---|
| 400 | Fix parameters against OpenAPI; do not retry unchanged. |
| 401 | Check Bearer, revocation or expiration. Fix credentials before retrying. |
| 403 | Check permissions or suspension. |
| 404 | Check resource and path. Empty collections may return 200. |
| 429 | Respect Retry-After. Keys share quotas. |
| 500 / 502 / 503 / 504 | Retry idempotent reads only, with bounded backoff and jitter. |
ETag / If-None-Match
Store the representation with its ETag. For the same URL and format send If-None-Match. On 304 reuse the stored body; do not parse an empty body as JSON. Keep the new request ID and check rate freshness. Never share personalized caches across accounts.
Partial response
An empty array is not a service failure. Check filters and coverage. When no usable rate exists, display “rate unavailable”; never replace null with zero or extend expiresAt.