Aller au contenu principal

Limites de débit

Limites par endpoint​

EndpointLimitePortée
POST /v2/email/validate100 requêtes par minutepar IP appelante
POST /v2/email/suggest/domain · suggest/typo-domain60 requêtes par minutepar IP appelante
GET /v2/billing/catalog120 requêtes par minutepar IP appelante
GET /v2/widget/config120 requêtes par minutepar IP du visiteur
POST /v2/widget/validate60 requêtes par minutepar IP du visiteur, tous widgets confondus
Widget (anti-abus)Limites par IP, par appareil et par jour, réglables par widgetvoir Widget
POST /mcp (serveur MCP)1 200 requêtes par minutepar IP appelante
Toutes les routes100 requêtes en cours en même tempspar IP appelante

« Par IP » désigne l'adresse publique de l'appelant : deux clients distincts ont chacun leur quota, même s'ils passent par le même relais réseau. Les adresses IPv6 d'un même préfixe /56 partagent un quota.

Limites par clé API​

Chaque appel authentifié par clé API est aussi compté par clé, quelle que soit l'IP appelante : POST /v2/email/validate, POST /v2/email/enrich, les suggestions, POST /v2/widget/validate et chaque requête au serveur MCP (une validation de liste en réponse immédiate compte en plus une fois par adresse). Le widget consomme la clé widget qui lui est liée, y compris pour les suggestions affichées pendant la frappe.

FenêtreLimite par défaut
Minute60 appels
Heure1 000 appels
Jour10 000 appels

Un appel refusé n'est décompté d'aucune fenêtre et n'est jamais facturé. Besoin de plus ? Écrivez au support : ces limites se relèvent par organisation. Les appels du tableau de bord (session connectée) ne sont pas concernés.

S'y ajoutent deux plafonds qui ne sont pas des limites de débit :

  • le plafond de crédits de la clé (journalier, mensuel), s'il est configuré : voir Authentification ;
  • le solde de l'organisation pour le SMTP : voir Crédits.

En-têtes​

POST /v2/email/validate et les deux endpoints de suggestion (suggest/domain, suggest/typo-domain) renvoient les en-têtes de la spécification IETF RateLimit (version draft-6) :

RateLimit-Policy: 100;w=60
RateLimit-Limit: 100
RateLimit-Remaining: 87
RateLimit-Reset: 42
En-têteContenu
RateLimit-PolicyQuota et fenêtre en secondes
RateLimit-LimitRequêtes autorisées dans la fenêtre
RateLimit-RemainingRequêtes restantes
RateLimit-ResetSecondes avant la réinitialisation (pas un horodatage)

La réponse 429​

Limite dépassée : 429 Too Many Requests avec un en-tête Retry-After en secondes. Attention, le corps dépend de la limite atteinte :

LimiteCorps
Débit par IP (validate, widget)Texte brut : Too many requests from this IP, please try again later
Limite d'appels de la cléJSON, code: "API_KEY_RATE_LIMITED", fenêtre atteinte dans details
Plafond de crédits de la cléJSON, code: "API_KEY_BUDGET_EXCEEDED", détail dans details
Anti-abus du widgetJSON, message: "Too many requests for this widget"
Requêtes simultanées (plus de 100 en cours)Page HTML, sans Retry-After : réduisez le nombre d'appels en parallèle

Lisez toujours Retry-After et attendez au moins ce délai :

async function validateWithRetry(email, attempts = 3) {
for (let i = 0; i < attempts; i++) {
const res = await fetch('https://api.yeswecheck.fr/v2/email/validate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.YWC_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
});

if (res.status !== 429) return res;

const wait = Number(res.headers.get('retry-after') ?? 60);
await new Promise((r) => setTimeout(r, wait * 1000));
}
throw new Error('Limite de débit YesWeCheck toujours atteinte');
}

Au-delà de quelques centaines d'adresses d'un coup, préférez le traitement par lots à une boucle d'appels.

Limites de taille​

ÉlémentLimite
Corps JSON d'une requête256 Ko (au-delà : 413) ; 2 Mo pour /mcp
Saisie de suggest/typo-domain320 caractères (au-delà : 400)
smtpTimeout1 000 à 30 000 ms
country2 ou 3 lettres (ISO 3166-1)
Fichier de traitement par lots15 Mo, 500 000 lignes, CSV ou TXT
Restrictions d'une clé20 IP et 20 domaines au plus