Isoloir 2027
Démarrer

Limites de débit

Chaque offre a un plafond par minute et un plafond par heure ou par jour. Chaque réponse dit où vous en êtes, avant que la limite ne tombe.

Mis à jour le 10 novembre 2026

Quotas par offre

OffreLimitesCompté parPrix
Sans clé anonyme10 par minute ; 60 par heureadresse IP0 €
Gratuit gratuit60 par minute ; 5 000 par jourclé0 €
Pro pro300 par minute ; 100 000 par jourclé29 € HT / mois
Entreprise entreprise1 200 par minute ; 1 000 000 par jourclé99 € HT / mois

Les fenêtres sont fixes : une minute pleine de l'horloge, une heure pleine, un jour du calendrier en temps universel (de 1 h à 1 h du matin à Paris en hiver, de 2 h à 2 h en été). Une requête refusée ne compte pas : réessayer après un 429 ne repousse pas la remise à zéro. Toutes les requêtes comptent de la même façon, quel que soit le point d'accès ou la taille de la réponse.

Les en-têtes de chaque réponse

L'API suit le projet de norme de l'IETF sur les en-têtes de limite de débit. Ils décrivent la fenêtre la plus proche de la limite : le plafond par minute en cas de rafale, le plafond par heure ou par jour sinon.

En-têtes
RateLimit-Limit: 60
RateLimit-Remaining: 57
RateLimit-Reset: 2280
RateLimit-Policy: 10;w=60, 60;w=3600
Exemple sans clé : 57 requêtes restent sur les 60 de l'heure en cours, remise à zéro dans 2 280 secondes.
  • RateLimit-Limit : le plafond de la fenêtre décrite ;
  • RateLimit-Remaining : les requêtes qui restent dans cette fenêtre ;
  • RateLimit-Reset : le nombre de secondes avant sa remise à zéro (une durée, pas une date) ;
  • RateLimit-Policy : toutes les fenêtres de l'offre, sous la forme plafond;w=durée en secondes.

Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset des premières versions restent envoyés ; le dernier y est une date Unix, comme à l'origine.

Quand la limite est atteinte

L'API répond 429 rate_limited avec un en-tête Retry-After en secondes. Attendez au moins ce délai avant de réessayer ; un client qui insiste n'obtient rien de plus, et ses requêtes refusées ne sont pas comptées.

JavaScript
async function get(url, key) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const res = await fetch(url, { headers: { Authorization: `Bearer ${key}` } });
    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 atteinte trois fois de suite");
}

Rester sous les limites

  • Mettez les réponses en cache au moins cinq minutes : c'est la durée de Cache-Control, et la plupart des données ne changent qu'une fois par heure (publications), toutes les six heures (abonnés) ou par jour (Wikipédia). /api/v1/etat dit quand la collecte a écrit pour la dernière fois.
  • Filtrez côté serveur : candidat, reseau, depuis et jusqua réduisent la réponse sans coûter de requête en plus.
  • Pour un historique complet, une requête CSV vaut mieux que cent requêtes JSON.
  • Pour un besoin ponctuel au-delà des quotas (une étude, un traitement unique), écrivez à contact@isoloir2027.fr avant de lancer le traitement.