Rate Limits & Quotas

Limites par défaut

Endpoint	Limite	Fenêtre	Scope
POST /email/validate	100 req	1 minute	Par IP
Tous les autres endpoints	Pas de limite globale	—	—
Batch upload	1 job actif	Simultané	Par organisation

Headers de rate limit

Chaque réponse inclut les headers standard :

HTTP/1.1 200 OK
RateLimit-Limit: 100
RateLimit-Remaining: 87
RateLimit-Reset: 1709123456

Erreur 429 (Too Many Requests)

HTTP 429 Too Many Requests
Retry-After: 42

{
  "message": "Too many requests from this IP, please try again later",
  "statusCode": 429
}

Gérer le rate limit dans votre code

async function validateWithRetry(email, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch('/v2/email/validate', {
      method: 'POST',
      headers: { 'X-API-Key': apiKey },
      body: JSON.stringify({ email }),
    });

    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get('Retry-After') || '60');
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }

    return await response.json();
  }

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

Rate limits par API Key

Les rate limits peuvent être configurés par API Key depuis le Dashboard :

• Requêtes par minute
• Requêtes par heure
• Requêtes par jour

# Consulter les rate limits de votre organisation
curl https://api.yeswecheck.fr/v2/api-keys/rate-limits \
  -H "Authorization: Bearer VOTRE_JWT"

Bonnes pratiques

Pour la validation en temps réel

• Ne déclenchez la validation que sur blur (quand l'utilisateur quitte le champ)
• Ajoutez un debounce de 500ms minimum pour éviter les appels en cours de frappe
• Mettez en cache les résultats de validation côté client (5-10 min)

Pour les intégrations batch

• Utilisez l'endpoint /batch/upload plutôt que d'appeler /email/validate en boucle
• Le batch est optimisé pour le traitement parallèle et respecte automatiquement les limites SMTP

Déduplications

• Le batch déduplique automatiquement les emails par défaut (deduplicate: true)
• Pour la validation unitaire, dédupliquez côté client avant d'appeler l'API

Limites de taille

Ressource	Limite
Fichier batch	10 Mo
Emails par batch	~200 000
Timeout SMTP	1 000 – 30 000 ms
Longueur email	254 caractères (RFC 5321)