Limites de débit
Limites par endpoint
| Endpoint | Limite | Portée |
|---|---|---|
POST /v2/email/validate | 100 requêtes par minute | par IP appelante |
POST /v2/email/suggest/domain · suggest/typo-domain | 60 requêtes par minute | par IP appelante |
GET /v2/billing/catalog | 120 requêtes par minute | par IP appelante |
GET /v2/widget/config | 120 requêtes par minute | par IP du visiteur |
POST /v2/widget/validate | 60 requêtes par minute | par IP du visiteur, tous widgets confondus |
| Widget (anti-abus) | Limites par IP, par appareil et par jour, réglables par widget | voir Widget |
POST /mcp (serveur MCP) | 1 200 requêtes par minute | par IP appelante |
| Toutes les routes | 100 requêtes en cours en même temps | par 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être | Limite par défaut |
|---|---|
| Minute | 60 appels |
| Heure | 1 000 appels |
| Jour | 10 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ête | Contenu |
|---|---|
RateLimit-Policy | Quota et fenêtre en secondes |
RateLimit-Limit | Requêtes autorisées dans la fenêtre |
RateLimit-Remaining | Requêtes restantes |
RateLimit-Reset | Secondes 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 :
| Limite | Corps |
|---|---|
| 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 widget | JSON, 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ément | Limite |
|---|---|
| Corps JSON d'une requête | 256 Ko (au-delà : 413) ; 2 Mo pour /mcp |
Saisie de suggest/typo-domain | 320 caractères (au-delà : 400) |
smtpTimeout | 1 000 à 30 000 ms |
country | 2 ou 3 lettres (ISO 3166-1) |
| Fichier de traitement par lots | 15 Mo, 500 000 lignes, CSV ou TXT |
| Restrictions d'une clé | 20 IP et 20 domaines au plus |