# Cloudflare-Prüfseite

> Mit YesCaptcha die "Just a moment..."-Prüfseite von Cloudflare passieren und cf_clearance sowie weitere Cookies, den User-Agent und den Seiteninhalt erhalten: Parameter von CloudFlareTaskS2 und CloudFlareTaskS3, Proxy-Anforderungen, Ergebnis, Verwendung des Ergebnisses und häufige Fehler.

Source: https://docs.yescaptcha.com/de/tasks/cloudflare-challenge/ · Last verified: 2026-10-19

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/tasks/cloudflare-challenge/

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.

- POST `https://api.yescaptcha.com/createTask` (Globaler Endpoint)
- POST `https://cn.yescaptcha.com/createTask` (China-Endpoint)

## 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](https://docs.yescaptcha.com/de/tasks/turnstile.md) 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:pass@proxy.example.com: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:pass@proxy.example.com: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:pass@proxy.example.com: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

```json
{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "CloudFlareTaskS3",
    "websiteURL": "https://example.com/",
    "proxy": "http://user:pass@proxy.example.com: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](https://docs.yescaptcha.com/de/api/get-task-result.md).

## Ergebnis

```json
{
  "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](https://docs.yescaptcha.com/de/api/errors.md).

## Verwandte Themen

-   [Captcha-Typ bestimmen](https://docs.yescaptcha.com/de/guides/identify-captcha.md): Unterschied zwischen Cloudflare-Prüfseite und Turnstile
-   [Cloudflare Turnstile](https://docs.yescaptcha.com/de/tasks/turnstile.md)