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.

HTTPAction
400Fix parameters against OpenAPI; do not retry unchanged.
401Check Bearer, revocation or expiration. Fix credentials before retrying.
403Check permissions or suspension.
404Check resource and path. Empty collections may return 200.
429Respect Retry-After. Keys share quotas.
500 / 502 / 503 / 504Retry 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.