Cloudflare-Prüfseite

Die Cloudflare-Prüfseite ist eine Seite, die den gesamten Zugriff auf eine Website blockiert und “Just a moment…” bzw. “Ihr Browser wird überprüft” anzeigt. YesCaptcha öffnet die Seite über den von Ihnen angegebenen Proxy, besteht die Prüfung und gibt Cookies wie cf_clearance, den verwendeten User-Agent, die Request- und Response-Header sowie das HTML der Seite nach der Prüfung zurück. CloudFlareTaskS2 kostet 25 Punkte (≈ $3.75 / 1k) pro Aufgabe, CloudFlareTaskS3 kostet 20 Punkte (≈ $3.00 / 1k) pro Aufgabe. Beide Typen haben dieselben Parameter, dasselbe Ergebnis und dieselbe Wirkung und unterscheiden sich nur im Preis. Die Antwort erfolgt asynchron; eine Aufgabe dauert in der Regel 6 bis 35 Sekunden, je nach Website mit großen Unterschieden. Bei fehlgeschlagener Erkennung oder Timeout erfolgt automatisch eine Punkteerstattung.

POSThttps://api.yescaptcha.com/createTaskGlobaler EndpointKopieren

POSThttps://cn.yescaptcha.com/createTaskChina-EndpointKopieren

Anwendungsfälle

• Der Seitenquelltext enthält __cf_chl_rt_tk oder cdn-cgi/challenge-platform, und der Titel lautet Just a moment...: Das ist die Cloudflare-Prüfseite. Auch Prüfseiten, auf denen Sie das Kontrollkästchen “Bestätigen Sie, dass Sie ein Mensch sind” anklicken müssen, werden mit dieser Seite behandelt.
• Wenn nur ein Cloudflare-Widget in einem Formular eingebettet ist, handelt es sich um Turnstile und nicht um diese Seite.
• Wenn Sie mit einer Bibliothek wie requests den Status 403 und “Just a moment…” erhalten, der Browser die Seite aber direkt öffnen kann: Meist wird nur der TLS-Fingerprint blockiert. Verwenden Sie eine Bibliothek, die den TLS-Fingerprint eines Browsers nachahmt (z. B. curl_cffi); dann ist keine Lösung der Prüfung nötig.

Typen und Preise

Aufgabentyp	Preis	Modus	Hinweise
CloudFlareTaskS2	$3.75 / 1k; 25 Punkte/Aufgabe · ¥25 / 1k	Asynchron	Eigener Proxy
CloudFlareTaskS3	$3.00 / 1k; 20 Punkte/Aufgabe · ¥20 / 1k	Asynchron	Eigener Proxy

Die Preise in US-Dollar sind Schätzwerte bei 1 US$ ≈ ¥6.67; Aufgaben werden in Punkten berechnet.

Anfrageparameter

Feld	Typ	Erforderlich	Beschreibung
type	string	Ja	Aufgabentyp; siehe „Aufgabentypen und Preise“ auf dieser Seite
websiteURL	string	Ja	Vollständige URL der Seite hinter der Prüfseite. Muss eine öffentliche URL mit http:// oder https:// sein; private IP-Adressen sowie lokale oder interne Hostnamen wie localhost werden abgelehnt
proxy	string	Ja	Proxy als ein String: http://user:[email protected]:8080 (HTTP-Proxy, Zugangsdaten optional) oder socks5://proxy.example.com:1080 (ohne Zugangsdaten). https://-Proxys und SOCKS5 mit Zugangsdaten werden nicht unterstützt, und lokale oder private Adressen werden abgelehnt. Alle Anfragen für die Zielseite laufen über diesen Proxy
userAgent	string	Nein	In der Regel weglassen. Nur ein User-Agent von Desktop-Chrome unter Linux wird verwendet; alles andere (Windows, macOS, Mobilgeräte, andere Browser) wird ignoriert. Verwenden Sie für spätere Anfragen immer user_agent aus dem Ergebnis
waitLoad	boolean	Nein	Standardmäßig false. Bei true wartet die Aufgabe nach bestandener Prüfung, bis die Netzwerkaktivität der Seite zur Ruhe kommt, bevor sie das Ergebnis zurückgibt; content enthält dann mehr dynamisch nachgeladene Inhalte, und es dauert einige Sekunden länger
requiredCookies	array	Nein	Namen der Cookies, die zwingend erhalten werden müssen, als Array von Strings, z. B. ["cf_clearance"]. Wenn angegeben, ist die Aufgabe nur erfolgreich, wenn alle erhalten wurden; andernfalls gibt sie ERROR_CAPTCHA_UNSOLVABLE zurück und es erfolgt eine Punkteerstattung. Wenn weggelassen, versucht die Aufgabe trotzdem, cf_clearance zu erhalten, gilt aber auch mit anderen erhaltenen Cookies als erfolgreich (mit Punkteabzug); geben Sie es daher ausdrücklich an, wenn Sie cf_clearance benötigen
blockImage	boolean	Nein	Bei true werden Bilder der Zielseite nicht geladen (außer denen, die die Cloudflare-Prüfung selbst benötigt), was Proxy-Traffic spart
postData	object	Nein	Wenn gesetzt, wird es wie ein normales HTML-Formular per POST an websiteURL gesendet (application/x-www-form-urlencoded): Jeder Schlüssel ist ein Formularfeld, und die Werte werden als Strings gesendet, z. B. {"name": "hi"}. Muss ein Objekt sein

Proxy-Anforderungen

proxy ist ein Pflichtfeld; alle Anfragen zum Öffnen der Zielseite laufen über diesen Proxy. cf_clearance ist an die Exit-IP gebunden, daher müssen Sie auch bei späteren Zugriffen auf die Zielwebsite denselben Proxy verwenden.

Schreibweise	Unterstützt
http://user:[email protected]:8080	Ja: HTTP-Proxy mit Benutzername und Passwort
http://proxy.example.com:8080	Ja: HTTP-Proxy ohne Benutzername und Passwort
socks5://proxy.example.com:1080	Ja: SOCKS5-Proxy ohne Benutzername und Passwort; socks5h:// wird wie socks5:// behandelt
socks5://user:[email protected]:1080	Nein, gibt ERROR_PROXY_INCORRECT zurück; wenn Sie Zugangsdaten benötigen, verwenden Sie stattdessen einen HTTP-Proxy
https://proxy.example.com:443 oder andere Protokolle, oder fehlender Port	Nein, gibt ERROR_PROXY_INCORRECT zurück
Lokale, interne oder reservierte Adressen wie 127.0.0.1, 192.168.x.x, 10.x.x.x oder Domains, die auf solche Adressen auflösen	Abgelehnt, gibt ERROR_PROXY_BANNED zurück

Prüfung beim Erstellen der Aufgabe

Bei ungültiger URL oder ungültigem Proxy gibt createTask sofort einen Fehler zurück, es erfolgt kein Punkteabzug. Wenn die Verbindung zu einem Proxy in kurzer Zeit mehrfach fehlschlägt, gibt auch das Erstellen von Aufgaben mit diesem Proxy für einige Zeit direkt ERROR_PROXY_BANNED zurück. Verwenden Sie einen anderen Proxy oder versuchen Sie es später erneut.

User-Agent

Übergeben Sie in der Regel kein userAgent. Die Prüfung wird mit Chrome für Linux-Desktop bestanden, daher wird nur ein User-Agent von Chrome für Linux-Desktop übernommen; alle anderen (Windows, macOS, Mobilgeräte oder andere Browser) werden ignoriert: In Tests besteht die Cloudflare-Prüfung nicht, wenn die tatsächliche Browserumgebung nicht zum User-Agent passt. Verwenden Sie für alle weiteren Anfragen den user_agent aus dem Ergebnis.

Anfragebeispiel

POST https://api.yescaptcha.com/createTask

{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "CloudFlareTaskS3",
    "websiteURL": "https://example.com/",
    "proxy": "http://user:[email protected]:8080",
    "requiredCookies": ["cf_clearance"]
  }
}

• Für CloudFlareTaskS2 ändern Sie nur type, alles andere bleibt gleich.
• Wenn requiredCookies auf ["cf_clearance"] gesetzt ist, schlägt die Aufgabe fehl und die Punkte werden erstattet, falls cf_clearance nicht erhalten wird. Ohne diese Angabe gilt die Aufgabe auch dann als erfolgreich und es erfolgt ein Punkteabzug, wenn nur andere Cookies, aber kein cf_clearance erhalten wurden.
• Um ein Formular zu senden, fügen Sie postData hinzu, zum Beispiel {"name": "hi"}; es wird als POST-Formular an websiteURL gesendet.

Rufen Sie nach dem Erstellen alle 5 Sekunden getTaskResult ab. Der Ablauf ist derselbe wie bei anderen asynchronen Aufgaben, siehe getTaskResult.

Ergebnis

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "cookies": {
      "cf_clearance": "Wq3vXk9...-1760860800-1.2.1.1-..."
    },
    "request_headers": {
      "accept-language": "en-US,en;q=0.9",
      "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36"
    },
    "headers": {
      "content-type": "text/html; charset=UTF-8",
      "server": "cloudflare"
    },
    "content": "<!DOCTYPE html>..."
  }
}

Die Cookie-Werte und Header oben sind nur Beispiele; maßgeblich ist die tatsächliche Antwort.

Feld	Typ	Beschreibung
cookies	object	Alle Cookies im Browser nach bestandener Prüfung (Objekt mit Name-zu-Wert-Zuordnung), enthält in der Regel cf_clearance; wenn Sie requiredCookies gesetzt haben, ist jedes davon enthalten. Verwenden Sie sie zusammen mit dem zurückgegebenen user_agent und dem Proxy, den Sie angegeben haben
user_agent	string	Der User-Agent, den der Browser tatsächlich zum Bestehen der Prüfung verwendet hat (Desktop-Chrome unter Linux). cf_clearance ist daran gebunden, verwenden Sie ihn daher für alle Folgeanfragen
request_headers	object	Request-Header, die der Browser bei seiner letzten Anfrage an die Zielseite gesendet hat; verwenden Sie sie in Folgeanfragen erneut
headers	object	Response-Header der Zielseite nach bestandener Prüfung
content	string	HTML-Quelltext der Zielseite nach bestandener Prüfung

Ergebnis verwenden

1. Verwenden Sie für weitere Anfragen gleichzeitig die zurückgegebenen cookies, den zurückgegebenen user_agent und denselben Proxy wie beim Erstellen der Aufgabe. cf_clearance ist an User-Agent und Exit-IP gebunden; weicht eines der drei ab, erscheint die Prüfseite erneut.
2. Senden Sie nach Möglichkeit auch die request_headers mit und verwenden Sie einen browserähnlichen TLS-Fingerprint (z. B. die Option impersonate von curl_cffi).
3. cf_clearance hat eine Gültigkeitsdauer (von der Zielwebsite festgelegt, teils bis zu 1 Stunde). Innerhalb dieser Zeit müssen Sie die Prüfung nicht erneut lösen; bei zu hoher Anfragefrequenz kann Cloudflare die IP sperren.
4. Wenn Sie nur den Seiteninhalt benötigen, können Sie direkt content verwenden und müssen die Seite nicht erneut abrufen.

Häufige Fehler

Fehler, die beim Erstellen der Aufgabe zurückgegeben werden, führen zu keinem Punkteabzug; bei Aufgaben, die nach dem Erstellen fehlschlagen oder in ein Timeout laufen, erfolgt automatisch eine Punkteerstattung. Die API gibt nur den Fehlercode und eine allgemeine Beschreibung zurück; die konkrete Ursache entnehmen Sie der folgenden Tabelle.

Fehlercode	Wann er zurückgegeben wird	Was zu tun ist
ERROR_REQUIRED_FIELDS	Beim Erstellen der Aufgabe: websiteURL oder proxy fehlt	Beide Pflichtfelder ergänzen
ERROR_ILLEGAL_PARAMETERS	Beim Erstellen der Aufgabe: websiteURL ist keine öffentliche URL mit http:// / https://, postData ist kein Objekt oder requiredCookies ist kein Array von Strings. Bei der Ergebnisabfrage: Die Domain der Ziel-URL kann über den Proxy nicht aufgelöst werden	Parameter korrigieren; Schreibweise der URL prüfen und prüfen, ob der Proxy die Website erreichen kann
ERROR_PROXY_INCORRECT	Beim Erstellen der Aufgabe: Das Proxy-Format ist falsch oder der Port fehlt, oder es wurde ein https://-Proxy bzw. ein SOCKS5-Proxy mit Zugangsdaten verwendet	Schreibweise gemäß “Proxy-Anforderungen” oben anpassen; wenn Zugangsdaten nötig sind, einen HTTP-Proxy verwenden
ERROR_PROXY_BANNED	Beim Erstellen der Aufgabe: Der Proxy ist eine lokale, interne oder reservierte Adresse, oder die Verbindung zu diesem Proxy ist in kurzer Zeit mehrfach fehlgeschlagen. Bei der Ergebnisabfrage: Cloudflare der Zielwebsite hat die IP dieses Proxys direkt blockiert (Seite “Sorry, you have been blocked” bzw. “Access denied”)	Anderen Proxy verwenden; je besser die IP-Qualität, desto leichter die Prüfung
ERROR_PROXY_CONNECT_REFUSED	Verbindung zum Proxy nicht möglich (Verbindung abgelehnt, Domain des Proxys nicht auflösbar), oder beim Öffnen der Seite über den Proxy wurde die Verbindung abgelehnt oder zurückgesetzt	Proxy-Adresse und Port prüfen, sicherstellen, dass der Proxy online ist und externe Zugriffe erlaubt; bei weiterem Fehlschlagen anderen Proxy verwenden
ERROR_PROXY_CONNECT_TIMEOUT	Zeitüberschreitung beim Verbinden mit dem Proxy oder beim Öffnen der Seite über den Proxy	Einen schnelleren, stabileren Proxy verwenden
ERROR_PROXY_NOT_AUTHORISED	Benutzername oder Passwort des Proxys sind falsch	Zugangsdaten in proxy prüfen; Sonderzeichen URL-kodieren
ERROR_PROXY_TLS_ERROR	Beim Öffnen der Seite über den Proxy ist der TLS-Handshake fehlgeschlagen	Proxy-Adresse, Port und Protokoll prüfen; bei weiterem Fehlschlagen anderen Proxy verwenden
ERROR_CAPTCHA_UNSOLVABLE	Die Prüfung wurde in der vorgegebenen Zeit nicht bestanden, die Seite zeigte nach dem Bestehen weiterhin die Prüfseite, oder ein in requiredCookies angefordertes Cookie wurde nicht erhalten	Zuerst mit einem anderen Proxy erneut versuchen; bei einzelnen Websites können Sie den Support kontaktieren
ERROR_NO_SLOT_AVAILABLE	Beim Erstellen der Aufgabe: Die Warteschlange ist voll. Bei der Ergebnisabfrage: Die Aufgabe hat zu lange in der Warteschlange gewartet und nicht begonnen, die Punkte wurden erstattet	Einige Sekunden warten und die Aufgabe erneut erstellen
ERROR_TASK_TIMEOUT	Die Aufgabe wurde nicht in der vorgegebenen Zeit abgeschlossen	Aufgabe erneut erstellen; anhaltende Timeouts deuten meist auf einen zu langsamen Proxy hin

Alle Fehlercodes finden Sie unter Fehlercodes.

Verwandte Themen

• Captcha-Typ bestimmen: Unterschied zwischen Cloudflare-Prüfseite und Turnstile
• Cloudflare Turnstile