Wat zijn de rate limits?

Laatst bijgewerkt: 3 maanden geleden

We handhaven momenteel geen strikte limieten voor verzoeken per seconde. Wel wordt verwacht dat je fair use toepast om de servicekwaliteit voor iedereen te behouden.

Huidige aanpak

In plaats van harde limieten moedigen we verantwoord gebruik aan:

  • Spreid je verzoeken op een redelijke manier

  • Gebruik exponential backoff wanneer er fouten optreden

  • Cache antwoorden om overbodige calls te vermijden

  • Neem contact met ons op als je veel verkeer verwacht

Best practices

Cacheer agressief:

  • Sla zoekresultaten op voor veelvoorkomende queries

  • Bewaar mediagegevens lokaal nadat je ze hebt opgehaald

  • Roep niet /confirm meerdere keren aan voor dezelfde gebruiker/resource

Bundel je bewerkingen:

  • Groepeer gerelateerde verzoeken samen

  • Voeg kleine vertragingen toe tussen batches

  • Beperk het aantal gelijktijdige verbindingen (10-20 is redelijk)

Behandel fouten op een soepele manier:

  • Implementeer retry-logica met exponential backoff

  • Probeer niet meteen opnieuw bij een mislukking

  • Log fouten voor monitoring

Verwachte responstijden

  • /resources search: meestal 200-500ms

  • /resource details: minder dan 100ms

  • /confirm licensing: 300-800ms

Stel je client-timeout in op minstens 30 seconden om af en toe tragere responstijden op te vangen.

Als je tegen limieten aanloopt

Dan ontvang je een 429 Too Many Requests fout. Als dit gebeurt:

// Implement exponential backoff
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, waitTime));
        continue;
      }
      
      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

Monitor je gebruik

Volg API-activiteit in Instellingen → API:

  • Bekijk het totaal aantal verzoeken

  • Controleer actieve licenties

  • Bekijk gebruikstrends

  • Let op ongebruikelijke patronen

Heb je hogere limieten nodig?

Als je legitieme use case veel verzoeken vereist (>1M verzoeken/maand), neem contact op met ons team om te bespreken:

  • Je applicatie en verkeerspatronen

  • Verwachte hoeveelheid verzoeken

  • Gegarandeerde rate limits indien nodig

Was dit artikel nuttig?