detail field.
{
"detail": "Rate limit exceeded. pro tier: 300 req/min."
}
Status codes
| Code | Meaning |
|---|---|
200 | Success |
201 | Created (webhooks) |
401 | No API key provided |
403 | Bad key or wrong tier for this feature |
404 | Alert or resource doesn’t exist |
429 | Rate limited — Retry-After header included |
500 | Server error — DM @alrerat |
Handling errors
r = requests.get(url, headers=headers)
if r.status_code == 429:
wait = int(r.headers.get("Retry-After", 60))
time.sleep(wait)
elif r.status_code == 403:
print("Wrong tier or bad key")
elif r.status_code != 200:
print(f"Error {r.status_code}: {r.json()['detail']}")
const r = await fetch(url, { headers });
if (r.status === 429) {
const wait = r.headers.get("Retry-After") || 60;
await new Promise(res => setTimeout(res, wait * 1000));
} else if (!r.ok) {
const err = await r.json();
console.error(`${r.status}: ${err.detail}`);
}