Getting Started

Limites de Taux

Comprendre les limites de requêtes API et comment les gérer

Limites de Taux

L'API Blitz Rocket applique des limites de taux pour garantir une utilisation équitable et protéger la stabilité du service. Les limites de taux sont appliquées par clé API et varient selon les points de terminaison.

Limites par Défaut

Catégorie de Point de TerminaisonLimiteFenêtre
Points de terminaison généraux100 requêtes1 minute
Création d'inscription au concours5 requêtes15 minutes (par IP + concours)
Vérification email/téléphone10 requêtes15 minutes (par IP + email)
Recherche d'inscription20 requêtes5 minutes (par IP)

En-têtes de Limite de Taux

Lorsque vous approchez ou dépassez les limites de taux, l'API renvoie un code d'état 429 Too Many Requests :

json
{
  "success": false,
  "error": "Limite de taux dépassée. Veuillez réessayer plus tard."
}

Bonnes Pratiques

  • Mettez en cache les réponses lorsque c'est possible pour réduire le nombre d'appels API
  • Implémentez un retour exponentiel lorsque vous recevez une réponse 429
  • Regroupez les opérations au lieu de faire de nombreuses requêtes individuelles
  • Utilisez des webhooks pour des mises à jour en temps réel au lieu de sonder les points de terminaison

Exemple : Retour Exponentiel

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

    if (response.status === 429) {
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise((resolve) => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }
  throw new Error("Max retries exceeded");
}