Limites de débit

Les limites de débit protègent l'API contre les abus et assurent une utilisation équitable pour tous les utilisateurs.

Limites par plan

| Plan | Requêtes/mois | Débit burst (req/min) | |---|---|---| | Gratuit | 500 | 10 | | Starter | 5 000 | 30 | | Growth | 25 000 | 60 | | Scale | 100 000 | 120 |

En-têtes de limite de débit

Chaque réponse API inclut les informations de limite de débit :

| En-tête | Description | |---|---| | X-RateLimit-Limit | Nombre maximum de requêtes par minute pour votre plan | | X-RateLimit-Remaining | Requêtes restantes dans la fenêtre actuelle | | X-RateLimit-Reset | Timestamp Unix de la réinitialisation |

Quand la limite est atteinte

Vous recevrez une réponse 429 Too Many Requests :

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded"
  }
}

Gérer les limites de débit

Backoff exponentiel

import time
import requests

def classify_with_retry(email, api_key, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(
            "https://api.emailclassifier.com/v1/classify",
            params={"email": email},
            headers={"Authorization": f"Bearer {api_key}"}
        )
        if response.status_code != 429:
            return response.json()

        wait = 2 ** attempt
        time.sleep(wait)

    raise Exception("Limite de débit dépassée après les tentatives")

Quota mensuel

Lorsque votre quota mensuel est atteint, toutes les requêtes retournent 429 jusqu'au prochain cycle de facturation. Vous pouvez :

1. Upgrader votre plan pour plus de requêtes
2. Attendre le mois suivant pour la réinitialisation du quota
3. Surveiller votre utilisation dans le Tableau de bord pour éviter les surprises