message is written for people and safe to show to your users. Branch on code, not on message. No error is ever billed: X-Credits-Used is 0.
Retrying
We already retry a source that fails for a moment (up to 3 tries, at most 2 seconds apart) before answering, so a502, 503 or 504 means the source stayed down across those tries. You are never charged for them.
- Retry after a wait:
429 rate_limitedand503 temporarily_unavailablecarry aRetry-Afterheader in seconds. - Retry later, perhaps with other parameters:
502 source_errorand504 timeout. - Don’t retry unchanged:
401,402,403,404,410and422will fail the same way until you change the key, the balance, the terms or the request.
request_id when you contact support.