reCAPTCHA Enterprise v3 API

Von solvethree Aktualisiert

Rufe von deinem Backend aus ein reCAPTCHA v3 Enterprise-Token ab. Konfiguriere die Website einmal und sende dann ihren Hostnamen, die Aktion und einen Proxy. Wir geben das Token zusammen mit dem User-Agent und den Client Hints zurück, die du beim Übermitteln verwenden musst.

API ausprobieren
Auf dieser Seite

Anfrage senden

Richte vor der ersten Lösung ein aktives Website-Profil in deinem Workspace ein. Sende den Hostnamen in site und die tatsächliche reCAPTCHA-Aktion der Seite in action. Enterprise v3 ist der Standard; verwende recaptchaType: v3 für Standard-v3. Der Task benötigt weder type noch eine vollständige Seiten-URL oder einen Website-Schlüssel.

Erstelle den Task mit POST https://api.solvethree.com/v1/tasks. Authentifiziere dich mit einem Workspace-API-Schlüssel im Header Authorization: Bearer.

Task-Body · Beispielziel und Proxy ersetzen
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

Token übermitteln

Lies solution.token aus, sobald der Task fertig ist. Übermittle es im CAPTCHA-Feld deiner Anwendung über denselben Proxy und verwende dabei die zurückgegebenen Werte userAgent und secChUa. Generiere die Lösung zeitnah zur Anfrage, die das Token benötigt; lege keinen Token-Cache für später an.

Ein Task mit dem Status ready bedeutet, dass die Lösung generiert wurde. Prüfe anhand der Antwort des Ziels, ob es die Anfrage akzeptiert hat.

Wartezeiten und Zeitüberschreitungen

Die Erstellung wartet standardmäßig bis zu 15 Sekunden. Verwenden Sie ?waitMs=0, wenn Sie lieber sofort eine Aufgaben-ID erhalten und deren Status abfragen möchten.

Beende das Polling bei ready oder failed. Wenn beim Erstellen eine Zeitüberschreitung auftritt, verwende die ursprüngliche requestId mit identischen Eingaben erneut, um den Task wieder abzurufen. Eine neue ID kann eine weitere kostenpflichtige Lösung erzeugen.

Preis

$2.00 pro 1,000 Lösungen, bezahlt aus Ihrem Arbeitsbereichsguthaben. Fehlgeschlagene Lösungen werden erstattet. Starten Sie mit $5 Willkommensguthaben; die Mindesteinzahlung beträgt $10.

reCAPTCHA Enterprise v3 API · solvethree