Cloudflare Turnstile
widget- Waar je het ziet
- Een widget binnen een pagina of formulier
- Wat het teruggeeft
- Een token in
cf-turnstile-response - CapMonster-pagina
- Deze pagina: Cloudflare Turnstile Oplosser
Laatst bijgewerkt:
| Bericht | Prijs (USD) |
|---|---|
$ 1.30 1000 tokens |
Een Cloudflare Challenge en een Turnstile widget kunnen er hetzelfde uitzien. Een uitdaging is niet altijd een aparte 'Even geduld...'-pagina: hij kan worden opgemaakt, in de site worden ingesloten of er uitzien als een gewone Turnstile-widget, zodat je ze niet van elkaar kunt onderscheiden door uiterlijk.
cf-turnstile-responsechallenge-form met __cf_chl_f_tk=cf_clearance cookieDe tabel vermeldt de prijs, de tijd om op te lossen en het succespercentage voor het oplossen van vier Cloudflare Turnstile oplossingsservices.
| Parameter | CapMonster Cloud | 2Captcha | Anti-Captcha | DeathByCaptcha |
|---|---|---|---|---|
Prijs per 1000 oplossingen (vanaf) | $ 1.30 | — | — | — |
Tijd om op te lossen | 6,24 s* | 16,9 sec | 20,33 sec | ~13 sec |
Succespercentage oplossen | 99%* | 96% | 96% | 96% |
2Captcha, Anti-Captcha en DeathByCaptcha zijn handelsmerken van hun respectievelijke eigenaren. CapMonster Cloud is niet gelieerd aan deze entiteiten. Prestatiestatistieken en prijsvergelijkingen zijn gebaseerd op openbaar beschikbare gegevens en interne benchmarking vanaf 02.10.2026.
Test nu meteen de stabiliteit op uw eigen doelsites. We kunnen geen succespercentage van 100% garanderen: CAPTCHA-typen en de configuratie van de doelsite kunnen op elk moment veranderen.
$0.10
Nieuwe gebruikers krijgen $ 0,10 aan testsaldo om CapMonster Cloud te proberen.
1. Registreer u op CapMonster Cloud.
2. Berichtondersteuning via livechat of support@capmonster.cloud waarbij het e-mailadres aan uw account is gekoppeld.
Voer aanmeldings-, afreken- en formulierstromen uit in CI/CD met Playwright, Puppeteer of Selenium op pagina's waarvan u de eigenaar bent of die u mag testen.
Controleer of beschermde formulieren en eindpunten blijven werken na releases en widgetwijzigingen.
Verzamel openbaar beschikbare gegevens van geopende pagina's die Cloudflare Turnstile gebruiken.
Ondersteun geautomatiseerde ondersteunende workflows op sites die afhankelijk zijn van invisible botcontroles.
Laat een agent een token aanvragen via MCP wanneer een workflow een captcha bereikt.
Gebruik CapMonster Cloud voor openbaar beschikbare gegevens en op sites waarvan u de eigenaar bent of die u mag testen. Het zonder toestemming verzamelen van gegevens van derden achter een login of betaalmuur is verboden.
Cloudflare Turnstile verifieert bezoekers via browsersignalen aan de clientzijde en risicobeoordeling in plaats van beeldpuzzels. Het wordt geleverd in drie widgetmodi: Managed (aanbevolen), Non-Interactive en Invisible. CapMonster Cloud verwerkt ze allemaal automatisch; u specificeert nooit de modus in de taak.
Bronnen: Cloudflare documentatie — Widgettypen · Aan de slag · Turnstile in Cloudflare uitdagingen
Turnstile kiest automatisch tussen een non-interactive vinkje en een selectievakje op basis van het risiconiveau van de bezoeker. Geen afbeeldingen of tekst om te ontcijferen.
Een zichtbare widget met een laadspinner. De controle wordt uitgevoerd zonder enige interactie van de bezoeker.
De controle loopt volledig op de achtergrond: er worden geen widget en geen laadindicator getoond.
De pagina laadt de widget-initcode; Cloudflare retourneert de vereiste JS en de widget wordt weergegeven.
Op basis van de widgetmodus en de risicosignalen van Cloudflare beslist de widget of er een interactieve uitdaging wordt weergegeven.
De clientzijde callback ontvangt een token — voor eenmalig gebruik, geldig gedurende 300 seconden. Als de widget zich in een <form> bevindt, wordt het token ook automatisch toegevoegd als het verborgen veld cf-turnstile-response.
De pagina stuurt het token naar de backend met de formuliergegevens.
Uw server roept Cloudflare's Siteverify API aan om het token te bevestigen.
Bronnen: Cloudflare documentatie — De widget insluiten · Het token valideren
Een Turnstile-token is de tekenreeks die de widget genereert nadat deze een bezoeker heeft geverifieerd. De widget slaat deze op in een verborgen formulierveld met de naam cf-turnstile-response en geeft deze ook door aan de widget callback. De server van de site stuurt het token vervolgens naar Cloudflare's Siteverify API om het te bevestigen.
Eigenschappen van het token, volgens de documentatie van Cloudflare's:
Geldig gedurende 300 seconden (5 minuten) na generatie.
Eenmalig gebruik: een tweede keer valideren levert de fout timeout-or-duplicate op.
Maximaal 2048 tekens lang.
Gevalideerd op de server via Siteverify API.
CapMonster Cloud accepteert captcha-parameters, verwerkt deze op zijn servers en retourneert een gebruiksklaar token. Voer dit token in het formulier in om de controle te doorstaan zonder tussenkomst van de gebruiker.
In dit stadium verzendt u uw API-sleutel, captcha-type en de bijbehorende parameters. De service retourneert een unieke taskId die u later kunt gebruiken om het resultaat te verkrijgen.
Vereiste parameters
| Parameter | Beschrijving |
|---|---|
| typ | TurnstileTask |
| websiteURL | De URL van de pagina waar de captcha is opgelost |
| websiteKey | Turnstile sitesleutel. Formaat: 0x4AAAAAAABUYP0XeMJF0xoy |
Optionele parameters
| Parameter | Beschrijving |
|---|---|
| userAgent | Browser User-Agent. Aanbevolen: geef de huidige waarde door, ondersteund door CapMonster Cloud. U kunt de laatste waarde verkrijgen op https://capmonster.cloud/api/useragent/actual |
| pageAction | Het actieveld dat wordt gevonden in de functie callback wanneer de captcha is geladen |
| gegevens | De waarde van het gegevensveld, ontleend aan de parameter cData |
| proxyType | http — normale HTTP/HTTPS-proxy; https — probeer dit als http niet werkt (vereist voor sommige aangepaste proxy's); socks4 — SOCKS4-proxy; socks5 — SOCKS5-proxy |
| proxyAdres | IP-adres van de proxy (IPv4/IPv6). Transparante proxy's en proxy's op lokale machines zijn niet toegestaan |
| proxyPoort | Proxy-poort |
| proxyInloggen | Proxy-gebruikersnaam |
| proxyWachtwoord | Proxywachtwoord |
Hetzelfde type TurnstileTask wordt gebruikt met en zonder proxy.
Eindpunt:
https://api.capmonster.cloud/createTaskVerzoek:
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "https://yourwebsite.com/page-with-turnstile",
"websiteKey": "your-website-key"
}
}Reactie:
{
"errorId": 0,
"taskId": 407533072
}Nadat u de taak hebt gemaakt, controleert u de oplossingsstatus.
Eindpunt:
https://api.capmonster.cloud/getTaskResultVerzoek:
{
"clientKey": "API_KEY",
"taskId": 407533072
}Reactie:
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}| Eigendom | Typ | Beschrijving |
|---|---|---|
| teken | Snaar | Gebruik het token in een invoerveld of bij het aanroepen van een callback-functie. |
Voer het geretourneerde token in het veld cf-turnstile-response in of geef het door aan callback van de widget en verzend het formulier binnen vijf minuten: Cloudflare tokens vervallen na 300 seconden en kunnen slechts één keer worden gevalideerd. Codevoorbeelden voor Playwright, Puppeteer en Selenium staan in de FAQ hieronder.
Om een taak Turnstile te maken, hebt u twee waarden nodig van de pagina waarop de widget wordt uitgevoerd: de sitesleutel (websiteKey) en, als de pagina deze instelt, de actienaam (pageAction).
<div class="cf-turnstile" data-sitekey="SITE_KEY"← websiteKey
data-action="ACTION"></div>← pageActionturnstile.render('#container', {
sitekey: 'SITE_KEY',← websiteKey
action: 'ACTION',← pageAction
callback: function (token) { /* ... */ }
});Open de site met de captcha.
Klik met de rechtermuisknop op het captcha-element en kies Inspect.
Zoek de sitesleutel. Op het tabblad Elements is dit het attribuut data-sitekey (websiteKey). Een sitesleutel Turnstile ziet eruit als 0x4AAAAAAABUYP0XeMJF0xoy.
Zoek de actie: in de widget render-aanroep (de functie callback die wordt uitgevoerd wanneer de captcha wordt geladen) of in het attribuut data-action. De sitekey is ook te vinden in die functie callback. Als de pagina geen actie instelt, laat u de parameter weg.
Om de waarden automatisch te verzamelen, laadt u de pagina in een headless browser zoals Playwright en leest u ze uit de weergegeven widget. Kant-en-klare voorbeelden in JavaScript, Python en C# staan in de documentatie CapMonster Cloud documentatie.
Sommige waarden veranderen elke keer dat de pagina wordt geladen, dus los de taak direct op nadat u ze heeft verzameld.
createTask en het resultaat kunt ophalen met getTaskResult met behulp van onze clientbibliotheken.Voor low-code-workflows gebruikt u het officiële knooppunt CapMonster Cloud n8n node.
websiteURL en websiteKey uit dezelfde weergave van de pagina.getTaskResult de status ready heeft geretourneerd en of u solution.token hebt gebruikt voordat u deze invoegde.Fouten geretourneerd door Cloudflare Siteverify (timeout-or-duplicate, invalid-input-secret en andere) hebben betrekking op site-eigenaren — zie “Siteverify foutcodes” hieronder.
Als u de website gebruikt die wordt beschermd door Turnstile: verifieer tokens en test uw configuratie
POST https://challenges.cloudflare.com/turnstile/v0/siteverify
secret=YOUR_SECRET_KEY
response=TOKENAls u de site beheert, valideert uw server elk Turnstile-token door een POST-verzoek te sturen naar https://challenges.cloudflare.com/turnstile/v0/siteverify. Het eindpunt accepteert application/x-www-form-urlencoded en JSON en retourneert altijd JSON. Vereiste parameters: secret (de geheime sleutel van uw widget) en response (het token). Optioneel: remoteip en idempotency_key. Vink success aan en, als u deze instelt, ook action en hostname in het antwoord.
Een token is 300 seconden geldig en kan slechts één keer worden gevalideerd. Lees meer in de validatiegidsCloudflare van Cloudflare.
Cloudflare biedt dummy-sitesleutels en geheime sleutels, zodat u een Turnstile-implementatie kunt testen zonder echte uitdagingen te veroorzaken. Testsitesleutels werken op elk domein, inclusief localhost, en genereren het dummy-token XXXX.DUMMY.TOKEN.XXXX. Dummy-tokens worden alleen geaccepteerd door dummy-geheime sleutels, en geheime productiesleutels weigeren deze.
<div class="cf-turnstile"
data-sitekey="1x…AA">
</div>
cf-turnstile-response:
"XXXX.DUMMY.TOKEN.XXXX"Gaat altijd voorbij
Het mislukt altijd
Gaat altijd voorbij
Het mislukt altijd
Dwingt een interactieve uitdaging af
Voldoet altijd aan de validatie
Mislukt altijd validatie
Retourneert de fout 'token al uitgegeven' (time-out of duplicaat)
Volledige referentie van Cloudflare: Turnstile testen.
Als de validatie mislukt, retourneert Cloudflare's Siteverify API een array error-codes. In de onderstaande tabel wordt elke code vermeld en wat deze betekent.
{
"success": false,
"error-codes": [
"timeout-or-duplicate"
]
}De geheime parameter is niet opgegeven
De geheime sleutel is ongeldig of verlopen
De antwoordparameter (token) is niet opgegeven
Het token is ongeldig, onjuist opgemaakt of verlopen
Het verzoek heeft een onjuiste indeling
Het token is al gevalideerd of is verlopen
Er is een interne fout opgetreden; Probeer het verzoek opnieuw
Siteverify kan success: true retourneren en uw server moet het token nog steeds weigeren als hostname of action niet overeenkomt met wat u verwacht.
Korte antwoorden over het oplossen van Cloudflare Turnstile met CapMonster Cloud: modi, proxy’s, tokens, testen en Siteverify-fouten.
Cloudflare Turnstile is een CAPTCHA-alternatief van Cloudflare dat bezoekers verifieert via browsersignalen en risicobeoordeling in plaats van beeldpuzzels. Het heeft drie widgetmodi. Managed (aanbevolen): Cloudflare kiest tussen een non-interactive vinkje en een selectievakje op basis van bezoekersrisico. Non-interactive: een zichtbare widget met een laadspinner die nooit interactie vereist. Invisible: helemaal geen widget. CapMonster Cloud verwerkt ze alle drie automatisch, dus u specificeert de modus niet in de taak.
Nee. TurnstileTask werkt zonder proxy en de proxyvelden (proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword) zijn optioneel. Een proxy die overeenkomt met de geografie van de doelsite kan de resultaten op geogevoelige pagina's verbeteren, dus het is de moeite waard om beide configuraties te testen. Transparante proxy's en proxy's op lokale machines zijn niet toegestaan. Zonder uw eigen proxy lost CapMonster Cloud de taak op via de ingebouwde proxy's (IP-adres 65.21.190.34).
Open DevTools, zoek het element met het attribuut data-sitekey (en data-action, als de pagina een actie instelt) en kopieer de waarden; een sitesleutel Turnstile ziet eruit als 0x4AAAAAAABUYP0XeMJF0xoy. Sommige waarden veranderen elke keer dat de pagina wordt geladen, dus extraheer ze vlak voordat u de taak maakt. Stapsgewijze instructies vindt u in het gedeelte hierboven.
cf-turnstile-response is het verborgen formulierveld dat het token Turnstile bevat. Het token is 300 seconden (5 minuten) geldig en kan slechts één keer worden gevalideerd; daarna retourneert Siteverify de fout timeout-or-duplicate. Dien meteen het token in dat je van CapMonster Cloud hebt ontvangen en vraag voor elke inzending een nieuw token aan.
Om een token Turnstile in te voegen, zoekt u het verborgen antwoordveld (een invoer met de naam cf-turnstile-response) en stelt u dit in op het token dat is opgehaald uit CapMonster Cloud. Hier leest u hoe u dit kunt doen in de drie automatiseringsframeworks.
Playwright / Puppeteer (Node.js):
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.querySelector('[name="cf-turnstile-response"]').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python):
token = "YOUR_TOKEN"
driver.execute_script("document.querySelector('[name=\"cf-turnstile-response\"]').value = arguments[0];", token)
driver.find_element("id", "submit-btn").click()Als het formulier het token valideert via een functie callback (het attribuut data-callback van de widget), roep dan die functie aan met het token.
Gebruik de dummy-sleutels van Cloudflare. Stel op de client de sitekey in op 1x00000000000000000000AA (gaat altijd goed), 2x00000000000000000000AB (mislukt altijd) of 3x00000000000000000000FF (dwingt een interactieve uitdaging af); op de server gebruikt u een dummy-geheime sleutel zoals 1x0000000000000000000000000000000AA. Dummy-sitesleutels werken op elk domein, inclusief localhost, en produceren het token XXXX.DUMMY.TOKEN.XXXX, dat alleen dummy-geheime sleutels accepteren. De volledige lijst staat in het gedeelte test hierboven.
Siteverify retourneert success: false als het token ouder is dan 300 seconden, al is gevalideerd of de geheime sleutel verkeerd is, en uw server kan deze ook weigeren als de geretourneerde hostname of action niet overeenkomt met wat u verwacht. Controleer de array error-codes in het antwoord en bekijk de foutcodetabel Siteverify foutcodetabel. Vraag voor elke inzending een nieuwe token aan en verstuur deze direct nadat u deze heeft ontvangen.
* We garanderen geen succespercentage van 100%: CAPTCHA-typen en doelsite-configuratie kunnen op elk moment veranderen. CapMonster Cloud levert een hoog succespercentage op voor het oplossen van Cloudflare Turnstile. Gebaseerd op de interne maandelijkse benchmarking van CapMonster Cloud Team. De daadwerkelijke oplossingssnelheid en het succespercentage variëren afhankelijk van de doelsite, de serverbelasting en de netwerkomstandigheden.
Cloudflare en Turnstile zijn handelsmerken van Cloudflare, Inc. CapMonster Cloud is niet verbonden met of onderschreven door Cloudflare. De Dienst is bedoeld voor openbaar beschikbare gegevens, het testen van uw eigen of geautoriseerde websites, beeldherkenning en toegankelijkheid. Het zonder toestemming verzamelen van gegevens van derden achter een login of betaalmuur is verboden; uw eigen accounts worden niet beïnvloed. Voordat u aan de slag gaat, bepaalt u de juridische status van uw gegevens.