Cloudflare purge-API-limieten, per abonnement
Cloudflare accepteert tot 100 items per purge-verzoek op Free, Pro en Business, en 500 bij het wissen per URL op Enterprise. Het aantal verzoeken is begrensd per account: 5 per minuut op Free, 5 per seconde op Pro, 10 per seconde op Business en 50 per seconde op Enterprise.
Laatst bijgewerkt:
Een handvol URL's wissen raakt geen enkele limiet. Duizend wissen wel, en de fout is niet duidelijk: de API geeft een fout terug voor het verzoek dat over de grens ging terwijl de eerdere zijn geslaagd, dus je houdt een half gewiste cache over zonder duidelijk signaal.
Hoeveel items per verzoek
| Abonnement | Items per verzoek | Wissen per URL |
|---|---|---|
| Free | 100 | 100 |
| Pro | 100 | 100 |
| Business | 100 | 100 |
| Enterprise | 100 | 500 |
«Items» zijn URL's, hostnames, tags of prefixen, afhankelijk van de methode. Ga je over het aantal heen, dan wordt het hele verzoek geweigerd: Cloudflare verwerkt niet de eerste honderd en laat de rest vallen, dus een naïef script dat 300 URL's stuurt wist er precies nul.
Hoeveel verzoeken
| Abonnement | Purge-verzoeken | Doorvoer bij wissen per URL |
|---|---|---|
| Free | 5 per minuut | 800 URL's/seconde |
| Pro | 5 per seconde | 1.500 URL's/seconde |
| Business | 10 per seconde | 1.500 URL's/seconde |
| Enterprise | 50 per seconde | 3.000 URL's/seconde |
Let op de eenheden. Free is vijf verzoeken per minuut, niet per seconde: een factor zestig verschil met Pro, en het meest verrassende getal op deze pagina. Bij 100 URL's per verzoek wist een Free-zone 500 URL's per minuut en geen een meer.
De limiet geldt per account, niet per zone. Dertig zones in een lus wissen telt als dertig verzoeken op hetzelfde budget, en dat is precies de vorm van een massale purge.
Wat dat in de praktijk betekent
Een paar sommen om in je hoofd te hebben voordat je de lus schrijft:
- 1.000 URL's op Free: 10 verzoeken, maar er mogen er 5 per minuut, dus minimaal twee minuten met een wachttijd ertussen.
- 1.000 URL's op Pro: 10 verzoeken bij 5 per seconde, zo'n twee seconden.
- 50 zones helemaal wissen op Free: 50 verzoeken bij 5 per minuut is tien minuten. Dit is het geval waarin een massale purge stuk lijkt en gewoon in de wachtrij staat.
De fouten die je echt gaat zien
| Antwoord | Wat het betekent | Wat te doen |
|---|---|---|
429 Too Many Requests | Je bent over het tempo van je abonnement gegaan | Wacht en probeer opnieuw met vertraging, nooit in een strakke lus |
Invalid API Token | Het token is fout, afgekapt of ingetrokken | Controleer het token; meestal is het onvolledig geplakt |
Authentication error (10000) | Het token is geldig maar mist Cache Purge:Purge | Voeg het recht toe en geef het opnieuw uit |
Too many URLs | Meer items dan per verzoek is toegestaan | Splits in batches van 100 of minder |
Hoe FlarePurge binnen de limieten blijft
FlarePurge groepeert purges per URL in batches van 30, bewust onder het plafond van 100 van Cloudflare. Die marge zit er omdat dat plafond eerder is verschoven, en een batch met ruimte blijft werken als het opnieuw verschuift.
Massale operaties over veel zones draaien met begrensde gelijktijdigheid in plaats van alle verzoeken tegelijk af te vuren, en elke batch meldt zijn eigen resultaat. Faalt er een zone, dan zie je welke, in plaats van één rode balk over een operatie die half werkte.
Welke purge-methode je moet kiezen staat in alles wissen of selectief wissen.