Errors

Errors use appropriate HTTP status codes and a JSON detail field: 400 malformed request, 404 missing record, 422 validation error, 429 too many requests, and 503 temporary dependency failure. Public reads never return 401 or 403 because no key is required; 401 applies only to partner webhook registration.

On 429, back off and retry after the indicated window. Feeds are cached for about five minutes, so polling faster than that gains nothing.