Status HTTP#
| Status | Causa |
|---|---|
| 401 | API key ausente, inválida ou revogada |
| 403 | API key sem o escopo exigido (ex.: donations:read) |
| 404 | Doação inexistente ou de outro streamer (nunca 403) |
| 422 | Filtro inválido (status ou since malformado) |
| 429 | Rate limit excedido — respeite Retry-After |
Rate limit#
Padrão: 100 requisições/min por API key (PUBLIC_API_RATE_LIMIT_MAX no servidor). Ao exceder:
http
HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1751900000
{"error":"..."}