Naar de inhoud

Limieten

Hoeveel verzoeken een sleutel per minuut mag doen.

Elke API-sleutel mag een vast aantal verzoeken per minuut doen. De limiet is een rem tegen scripts die doorslaan.

De limiet

WatWaarde
Verzoeken per venster120
Lengte van het venster60 seconden
Geteld perAPI-sleutel

Het venster is vast en begint bij het eerste verzoek. Het 121e verzoek binnen die 60 seconden krijgt een 429. Na afloop van het venster begint de telling opnieuw bij het eerstvolgende verzoek.

Verzoeken die al falen op de sleutel of de rechten, dus met een 401 of 403, tellen niet mee.

Als je de limiet haalt

JSON HTTP 429
{
	"error": {
		"message": "Te veel verzoeken. Maximaal 120 per minuut.",
		"code": "rate_limited"
	}
}

Let op

Er gaat geen Retry-After- of X-RateLimit-header mee. Je ziet dus niet hoeveel verzoeken je nog over hebt. Wacht na een 429 tot het venster van 60 seconden om is en probeer het dan opnieuw.

Binnen de limiet blijven

  • Haal lijsten op met de grootste pagina, limit=200, in plaats van veel kleine pagina's. Zie Paginering en filters.
  • Haal alleen op wat veranderd is met since, in plaats van steeds de hele lijst.
  • Gebruik webhooks om nieuwe leads en berichten te ontvangen, in plaats van steeds te vragen of er iets nieuws is.

Verder lezen