CompanyBelgium

Limitation de débit

Politique de limitation de débit et bonnes pratiques d'utilisation.

Limites par défaut

L'API applique un rate limiting intelligent par utilisateur (basé sur la clé API) pour garantir la qualité du service.

PlanRequêtes / minuteRequêtes / jour
Gratuit301 000
Standard6010 000

Stratégie de cache

Les réponses sont mises en cache pour optimiser les performances et réduire la charge sur les services BCE/KBO.

EndpointCacheStale-While-Revalidate
/api/companies/search10 minutes20 minutes
/api/companies/address10 minutes20 minutes
/api/companies/:id1 heure2 heures
/api/peppol/check1 heure2 heures

Gestion du rate limiting

Lorsque la limite est atteinte, l'API retourne un code 429. Implémentez un backoff exponentiel :

Backoff exponentiel
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      // Backoff exponentiel: 1s, 2s, 4s
      const delay = Math.pow(2, i) * 1000;
      console.log(`Rate limited. Retry in ${delay}ms...`);
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }

  throw new Error('Max retries exceeded');
}

Bonnes pratiques

  • Cachez les résultats localementÉvitez les requêtes répétées pour les mêmes données.
  • Utilisez la paginationNe chargez que les pages nécessaires.
  • Implémentez un backoff exponentielEn cas de code 429, attendez progressivement plus longtemps.
  • Évitez les requêtes en rafaleEspacez vos appels API de manière homogène.
  • Surveillez vos statistiquesConsultez votre tableau de bord pour suivre votre consommation.

Besoin d'aide ?

Notre equipe de support est disponible pour vous aider avec l'integration de l'API.