Limitation de debit et quotas

Quotas mensuels par plan

Chaque plan dispose d'un quota de requetes mensuel. Le compteur est reinitialise le premier jour de chaque mois a minuit UTC.

En-tetes de reponse

Chaque reponse de l'API inclut des en-tetes HTTP vous permettant de suivre votre consommation en temps reel.

Depassement de limite

Lorsque vous depassez la limite horaire ou le quota mensuel, l'API retourne un code 429 avec un message indiquant la raison. L'en-tete X-RateLimit-Reset vous indique quand vous pourrez de nouveau envoyer des requetes.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1713362400

{
  "success": false,
  "error": "Rate limit exceeded. Please try again later.",
  "timestamp": "2026-04-17T12:00:00.000Z"
}

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

    if (response.status === 429) {
      const resetTimestamp = response.headers.get('X-RateLimit-Reset');
      const waitMs = resetTimestamp
        ? (Number(resetTimestamp) * 1000) - Date.now()
        : Math.pow(2, i) * 1000;

      console.log(`Limite atteinte. Nouvelle tentative dans ${Math.ceil(waitMs / 1000)}s...`);
      await new Promise(resolve => setTimeout(resolve, Math.max(waitMs, 1000)));
      continue;
    }

    return response;
  }

  throw new Error('Nombre maximum de tentatives atteint');
}

Surveiller votre utilisation

Utilisez l'endpoint GET /api/v2/me pour consulter votre consommation en cours, les limites de votre plan et l'historique de vos cles API.

curl -H "X-API-Key: ${API_KEY}" -H "X-API-Secret: ${API_SECRET}" \
  https://companybelgium.be/api/v2/me

{
  "success": true,
  "data": {
    "plan": {
      "name": "Starter",
      "requestsPerHour": 500,
      "requestsPerMonth": 10000
    },
    "usage": {
      "currentMonth": {
        "requests": 3456,
        "startDate": "2026-04-01T00:00:00.000Z"
      }
    }
  },
  "timestamp": "2026-04-17T12:00:00.000Z"
}

Bonnes pratiques