Rate limieten & credits

Twee onafhankelijke meters zijn van toepassing: credits (wat een oproep kost) en rate limieten (hoe snel je kunt oproepen).

Credits

Data-dragende oproepen verbruiken credits uit jouw maandelijkse toelage. De gratis laag omvat 1.000 credits per maand, geen kaart vereist; betaalde plannen verhogen de toelage.

Oproep	Credit kosten
Volledige dataset download (/files/:format)	10
Coördinaten (/coordinates)	15
Archief maand (/archives/:month/:format)	20
Listing, metadata en gratis monsters	0

Openbare endpoints — GET /v1/dataset/all, GET /v1/dataset/:table, GET /v1/dataset/:table/sample/:format — kosten geen credits, zodat je kunt bladeren en inspecteren voordat je uitgeeft.

Volg het verbruik vanuit het accountportaal of via de API:

curl -H "Authorization: Bearer ..." \
  "https://api.topolab.nl/v1/credits/{organizationId}/api-usage?startDate=2026-05-01&endDate=2026-05-31"

Zie Gebruik statistieken voor de volledige rapportage endpoints.

Rate limieten

Aanvragen zijn per sleutel gelimiteerd over rollende vensters:

Venster	Limiet
Per seconde	50 aanvragen
Per 10 seconden	200 aanvragen
Per minuut	1.000 aanvragen

Het overschrijden van een venster geeft 429 Te Veel Aanvragen terug. Neem afstand en probeer opnieuw met exponentiële vertraging; batch waar je kunt (bijvoorbeeld, door items pagineren met limit tot 1.000 op de OGC API in plaats van functies één voor één op te halen).

Limieten goed hanteren

• Cache datasetbestanden lokaal en vernieuw ze op de cadans van de dataset in plaats van opnieuw te downloaden.
• Gebruik monsters (gratis) tijdens de ontwikkeling; besteed credits alleen aan echte pulls.
• Lees 429 als een signaal om te vertragen, niet om onmiddellijk opnieuw te proberen.
• Monitor gebruik via /v1/credits/{organizationId}/api-usage en stel je eigen waarschuwingen in.