Errors
| Status | Meaning | What to do |
|---|---|---|
200 |
The feed. | |
304 |
Unchanged since your If-None-Match. |
Keep your copy. See Caching. |
400 |
A filter or the currency is not valid. The body is a message. | Fix the query. See Filters and currency. |
404 |
Unknown feed, disabled feed, wrong token or wrong extension. | Check the key, token and extension. |
503 |
The catalogue is briefly unavailable. | Retry after the number of seconds in the Retry-After header (60). |
Why 404 covers so much
Section titled “Why 404 covers so much”An unknown feed, a disabled feed, a wrong token and a wrong extension all return the same 404, on purpose: the response never tells a caller which feed keys exist or whether a guessed token was close. If you get a 404 you did not expect, check the key and extension first, then the token.
Retrying
Section titled “Retrying”Retry a 503 once after Retry-After seconds, then fall back to your normal polling interval. Do not retry a 400 or 404 without changing the request.