Limites de l'API de purge Cloudflare, plan par plan
Cloudflare accepte jusqu'à 100 éléments par requête de purge sur les plans Free, Pro et Business, et 500 pour la purge par URL sur Enterprise. Le rythme des requêtes est plafonné par compte : 5 par minute sur Free, 5 par seconde sur Pro, 10 par seconde sur Business et 50 par seconde sur Enterprise.
Dernière mise à jour:
Purger quelques URL n'atteint aucune limite. En purger mille, si, et l'échec n'a rien d'évident : l'API renvoie une erreur pour la requête qui a franchi la ligne alors que les précédentes ont réussi, et vous vous retrouvez avec un cache purgé à moitié sans signal clair.
Combien d'éléments par requête
| Plan | Éléments par requête | Purge par URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
« Éléments » désigne des URL, hostnames, tags ou préfixes selon la méthode. Dépassez le nombre et la requête entière est rejetée : Cloudflare ne traite pas les cent premiers en abandonnant le reste, donc un script naïf qui envoie 300 URL n'en purge aucune.
Combien de requêtes
| Plan | Requêtes de purge | Débit de purge par URL |
|---|---|---|
| Free | 5 par minute | 800 URL/seconde |
| Pro | 5 par seconde | 1 500 URL/seconde |
| Business | 10 par seconde | 1 500 URL/seconde |
| Enterprise | 50 par seconde | 3 000 URL/seconde |
Attention aux unités. Free, c'est cinq requêtes par minute, pas par seconde : un facteur soixante par rapport à Pro, et le chiffre le plus surprenant de cette page. À 100 URL par requête, une zone Free purge 500 URL par minute et pas une de plus.
La limite s'applique par compte, pas par zone. Purger trente zones dans une boucle compte pour trente requêtes sur le même budget, ce qui est exactement la forme d'une purge en masse.
Ce que cela donne en pratique
Quelques calculs à avoir en tête avant d'écrire la boucle :
- 1 000 URL sur Free : 10 requêtes, mais seulement 5 autorisées par minute, donc deux minutes au minimum avec une attente au milieu.
- 1 000 URL sur Pro : 10 requêtes à 5 par seconde, environ deux secondes.
- 50 zones en purge totale sur Free : 50 requêtes à 5 par minute font dix minutes. C'est le cas où une purge en masse semble cassée alors qu'elle attend simplement son tour.
Les erreurs que vous verrez vraiment
| Réponse | Signification | Que faire |
|---|---|---|
429 Too Many Requests | Vous avez dépassé le rythme autorisé par votre plan | Attendez et réessayez avec un délai, jamais dans une boucle serrée |
Invalid API Token | Le token est faux, tronqué ou révoqué | Revérifiez-le ; un copier-coller incomplet est la cause habituelle |
Authentication error (10000) | Le token est valide mais il lui manque Cache Purge:Purge | Ajoutez la permission et réémettez-le |
Too many URLs | Plus d'éléments que le plafond par requête | Découpez en lots de 100 maximum |
Comment FlarePurge reste dans les limites
FlarePurge découpe les purges par URL en lots de 30, volontairement sous le plafond de 100 de Cloudflare. La marge est là parce que ce plafond a déjà bougé, et un lot confortablement en dessous continue de fonctionner quand il rebougera.
Les opérations en masse sur plusieurs zones tournent avec une concurrence plafonnée plutôt qu'en tirant toutes les requêtes d'un coup, et chaque lot rend compte de son résultat. Si une zone échoue, vous savez laquelle, au lieu d'un bandeau rouge sur une opération à moitié réussie.
Pour choisir la méthode de purge adaptée, voyez purger tout ou purge sélective.