Limites de débit

Comprenez les limites de requêtes de l'API, la consommation de crédits et comment gérer le throttling proprement.

Limites actuelles

Les quotas de requêtes et les crédits sont deux contrôles distincts. Par défaut, les clés API sont limitées à 60 requêtes par minute et 5,000 requêtes par jour. Ces quotas déterminent la fréquence à laquelle une intégration authentifiée peut appeler l'API. Les crédits du compte déterminent le nombre de vérifications possibles.

Pour le traitement de listes à fort volume, /api/batch accepte jusqu'à 500 e-mails par requête. Les imports CSV en masse dépendent des crédits et non du nombre de requêtes : le compte doit disposer d'assez de crédits pour le nombre d'e-mails du fichier importé avant que la vérification puisse démarrer.

Le vérificateur public anonyme est limité à 5 vérifications par jour et par adresse IP. Pour les règles de solde du compte, consultez Crédits et consommation. Pour les imports volumineux, utilisez Vérification en masse ; pour le comportement des intégrations, consultez Gestion des erreurs, Démarrage rapide, et tarifs.

Réponse en cas de limite atteinte

Lorsqu'une clé API dépasse son quota de requêtes, l'API renvoie une réponse 429 Too Many Requests . La réponse inclut Retry-After afin que le client sache combien de temps attendre avant de réessayer.

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry after the indicated delay.",
  "status_code": 429,
  "retry_after": 15
}

En-tête Retry-After

Le Retry-After L'en-tête de réponse indique combien de secondes attendre avant de relancer une requête par clé API ayant dépassé son quota :

HTTP/1.1 429 Too Many Requests
Retry-After: 15
Content-Type: application/json

Gérer les limites de requêtes dans le code

Lisez d'abord l'en-tête, attendez le nombre de secondes indiqué, puis réessayez. Si l'en-tête est absent, appliquez un délai de repli prudent.

import requests, time

def verify_with_retry(email, api_key, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(
            "https://verimails.com/api/verify/single",
            headers={"Authorization": f"Bearer {api_key}"},
            json={"email": email}
        )

        if response.status_code == 200:
            return response.json()

        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 15))
            print(f"Rate limited. Waiting {retry_after}s...")
            time.sleep(retry_after)
            continue

        response.raise_for_status()

    raise Exception("Max retries exceeded")

Bonnes pratiques

• Maintenez vos intégrations API authentifiées sous 60 requêtes par minute et 5,000 requêtes par jour, sauf si votre compte dispose de limites différentes.
• Limitez les payloads /api/batch à 500 e-mails maximum.
• Respectez toujours l'en-tête Retry-After lorsqu'une requête par clé API reçoit une erreur 429.
• Vérifiez vos crédits disponibles avant de lancer une vérification volumineuse.
• Utilisez la vérification en masse pour les listes CSV et assurez-vous que le compte dispose d'assez de crédits pour le nombre d'e-mails du fichier.