Rate limits & quota
Twee limieten draaien parallel: een maandelijks request-quotum gekoppeld aan je plan, en een per-minuut rate-plafond. Een van beide raken geeft 429.
Tier-limieten
| Tier | Per maand | Per minuut | Prijs |
|---|---|---|---|
| FREE | 1.000 | 10 | €0 |
| STARTER | 50.000 | 60 | €9,99 |
| GROWTH | 500.000 | 300 | €49,99 |
| SCALE | 5.000.000 | 1.000 | €149,99 |
Tellen
- Elke geauthenticeerde call naar
/v1/products/*verhoogt de teller met 1. 404-responses tellen mee, omdat het quotum na geldige authenticatie en vóór de endpoint-handler wordt verhoogd.- Ontbrekende of ongeldige sleutels tellen niet mee voor je maandquotum. Per-minuut
429-responses verhogen alleen de burst-teller; maandquotum-429s verhogen het maandquotum niet verder. - Publieke
/v1/statscalls tellen niet mee. - Tellers zijn per sleutel. Je totale maandelijkse gebruik is de som over al je sleutels.
- Maand-teller reset aan het begin van elke kalendermaand (UTC).
- Per-minuut-teller reset elke wandklok-minuut (UTC).
Response-headers
Elke geauthenticeerde response bevat:
X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 49873Deze reflecteren je maandelijkse quotum onder je huidige plan. Er is geen header voor de per-minuut-teller — behandel 429 met back-off.
Wanneer je een limiet raakt
Je ontvangt 429 Too Many Requests met een body zoals:
{
"error": "Monthly quota exceeded.",
"limit": 1000,
"tier": "FREE"
}Voor per-minuut-hits wordt een Retry-After: 60 header meegestuurd.
Upgraden midden in de maand
Upgrades zijn direct van kracht. Je maand-teller wordt niet gereset — het nieuwe plafond geldt voor de bestaande telling. Voorbeeld: je hebt 950 van 1.000 gebruikt op Free; upgraden naar Starter maakt direct 49.050 beschikbaar voor de rest van de maand.