Rate limits

Elke API-sleutel heeft een aanhoudende limiet van verzoeken-per-seconde afgeleid van je plan (Free 1 req/s → Max 60 req/s — zie Prijzen). Limieten worden afgedwongen met een token bucket: bursts tot je capaciteit per minuut zijn toegestaan, daarna worden verzoeken afgevlakt tot het aanhoudende tarief.

Wanneer je gelimiteerd bent

{ "error": "rate_limited", "retry_after_ms": 850 }

HTTP 429, error: "rate_limited".
retry_after_ms vertelt je de minimale wachttijd voordat je het opnieuw probeert.
De x-ratelimit-remaining-header op elke respons rapporteert hoeveel verzoeken er deze minuut nog over zijn.

Concurrency

Naast het tarief per seconde is er een limiet op in-flight-verzoeken. Als je veel verzoeken tegelijk afvuurt kun je het volgende zien:

409 request_in_progress — een identiek idempotent verzoek loopt al.
503 too_many_concurrent_requests — te veel gelijktijdige verzoeken in flight; pas backoff toe en probeer opnieuw.

Limieten afhandelen

Respecteer retry_after_ms; gebruik anders exponentiële backoff met jitter.
Houd een client-side concurrency-limiet aan die past bij het tarief van je plan.
De officiële SDK’s proberen 429/503 automatisch opnieuw.