API Error Catalog
Source: /home/vets-coin/flask_api/config/api_error_catalog.json | Updated: 2026-03-10T22:15:00Z
| Error Code | HTTP | Remediation | Retry |
|---|---|---|---|
| unauthorized | 401 |
Check signing key id, signature, and timestamp skew.
Verify nonce uniqueness to avoid replay rejections.
Confirm requested endpoint scope matches key permissions.
|
Do not blindly retry. Fix credentials/signature first.
|
| rate_limited | 429 |
Respect Retry-After and exponential backoff.
Reduce burst concurrency and reuse idempotency keys for retries.
Request higher quota only after proving sustained usage patterns.
|
Retry with exponential backoff (1s, 2s, 4s...) and jitter.
Retry-After: 60s
|
| rpc_unavailable | 503 |
Retry after cooldown window.
Inspect /api/public/rpc-circuit-breaker for open/closed state.
Validate upstream provider health before raising incident severity.
|
Retry after cooldown using capped exponential backoff.
Retry-After: 120s
|