Automatische CAPTCHA-Erkennung über die CapMonster Cloud API

Die CAPTCHA-Erkennung über die CapMonster Cloud API ist der automatisierte Prozess zur Erkennung und Lösung von Wörtern oder Symbolen über Programmierschnittstellen. Mit CapMonster Cloud können Sie CAPTCHA-Umgehungen automatisieren und Ihren Workflow vereinfachen und beschleunigen.

Wie es funktioniert

Die API löst CAPTCHAs mit folgendem Ablauf:

1. Anfrage senden

Der Client sendet eine Anfrage an den API-Server mit CAPTCHA-Daten (Bild, Site-Keys, URL).

2. Verarbeitung

Der API-Server verarbeitet die Anfrage, erkennt das CAPTCHA und beginnt mit der Lösung.

3. Empfang der Lösung

Der API-Server löst das CAPTCHA, sodass der Client mit der Verifizierung fortfahren kann.

Warum eine API zur CAPTCHA-Lösung verwenden?

APIs (Application Programming Interfaces) automatisieren Aktionen auf Websites.

Ausfüllen von Registrierungsformularen

Extrahieren und Kopieren von Daten

Senden verschiedener Informationen an einen Server

Automatisches CAPTCHA-Lösen per API

Die CapMonster Cloud API verwendet standardmäßige HTTP-Anfragen mit Daten im JSON-Format.

API-Adressen

createTask
Erstellt eine Aufgabe zur CAPTCHA-Lösung.
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Überprüft den Aufgabenstatus und ruft Ergebnisse ab.
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Ruft den aktuellen Kontostand ab.
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Stellt aktuelle Browser- und Betriebssystemdaten bereit.
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Captcha-Lösungsalgorithmus

Erhalt des Schlüssels

Zuerst holen Sie sich Ihren einzigartigen API-Schlüssel im CapMonster Cloud persönlichen Dashboard.

Senden einer Anfrage zur Erstellung einer Aufgabe

Senden Sie eine HTTP-POST-Anfrage an die Adresse:

https://api.capmonster.cloud/createTask

Fügen Sie Ihren API-Schlüssel und die Aufgabendetails in die Anfrage ein.

So sollte Ihre Anfrage aussehen:

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Der Server gibt die CAPTCHA-Kennung (taskId) oder einen Fehlercode zurück, wenn etwas schiefgeht.

Erhalt der Antwort

Nach dem Erstellen der Aufgabe senden Sie eine Anfrage, um die Antwort an die Adresse zu erhalten:

https://api.capmonster.cloud/getTaskResult

Fügen Sie Ihren API-Schlüssel und die Aufgabenkennung (taskId) ein.

So sollte Ihre Anfrage aussehen:

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

Der Server löst das CAPTCHA oder gibt an, dass die Aufgabe noch in Bearbeitung ist.

Beispielantwort:

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

Fehlerbehandlung: Haupttypen und Fehlerbehebungsanweisungen

Hauptfehler, die auftreten können:

INVALID KEY

API-Fehlercode: ERROR_KEY_DOES_NOT_EXIST

Diese Meldung zeigt an, dass der eingegebene API-Schlüssel falsch oder nicht vorhanden ist. Überprüfen Sie, ob Sie ihn korrekt eingegeben haben, und versuchen Sie es erneut.

NO FUNDS

API-Fehlercode: ERROR_ZERO_BALANCE

Diese Meldung weist darauf hin, dass Sie nicht genügend Guthaben haben, um die Aufgabe abzuschließen (d.h. das Guthaben ist null). Laden Sie Ihr Konto auf, um weiter zu lösen.

BIG IMAGE SIZE

API-Fehlercode: ERROR_TOO_BIG_CAPTCHA_FILESIZE

Diese Meldung zeigt an, dass die CAPTCHA-Größe überschritten wurde.

ZERO IMAGE SIZE

API-Fehlercode: ERROR_ZERO_CAPTCHA_FILESIZE

Diese Meldung zeigt an, dass die hochgeladene CAPTCHA-Größe weniger als 100 Byte beträgt.

CAPTCHA ID IS NOT FOUND

API-Fehlercode: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

Das CAPTCHA wurde im System nicht gefunden (seine ID konnte nicht lokalisiert werden). Der CAPTCHA-Status sollte innerhalb der ersten 5 Minuten nach der Einreichung überprüft werden. Stellen Sie sicher, dass Sie innerhalb dieses Zeitraums überprüfen.

CAPTCHA UNSOLVABLE

API-Fehlercode: ERROR_CAPTCHA_UNSOLVABLE

Diese Art von CAPTCHA wird vom Dienst nicht unterstützt, oder das Bild enthält keine lesbare Antwort, was bedeutet, dass es Rauschen ist. Es könnte beschädigt oder falsch gerendert sein.

CAPTCHA IS NOT READY

API-Fehlercode: CAPTCHA_NOT_READY

Das CAPTCHA wurde noch nicht gelöst. Warten Sie ein oder zwei Minuten.

REQUEST IS NOT ALLOWED FROM YOUR IP

API-Fehlercode: ERROR_IP_NOT_ALLOWED

Diese Meldung zeigt an, dass die Anfrage von dieser IP-Adresse abgelehnt wurde. Öffnen Sie Ihre persönlichen Kontoeinstellungen und fügen Sie Ihre IP zur Zulassungsliste hinzu.

IP BANNED

API-Fehlercode: ERROR_IP_BANNED

Sie haben das Anfragelimit mit einem falschen API-Schlüssel überschritten. Überprüfen Sie den Schlüssel und versuchen Sie, die Aufgabe erneut zu erstellen.

INCORRECT METHOD

API-Fehlercode: ERROR_NO_SUCH_METHOD

Der CAPTCHA-Typ (Wert des Parameters "type") ist falsch. Überprüfen Sie die Korrektheit der verwendeten Methode.

THE TOKEN IS EXPIRED

API-Fehlercode: ERROR_TOKEN_EXPIRED

Beim Erkennen des CAPTCHAs hat der Anbieter festgestellt, dass das zusätzliche Token abgelaufen ist. Erstellen Sie eine neue Aufgabe, holen Sie sich ein neues Token und versuchen Sie die Anfrage erneut.

NO FREE SERVERS

API-Fehlercode: ERROR_NO_SLOT_AVAILABLE

Alle Server sind beschäftigt. Versuchen Sie es später noch einmal.