Ihre erste CAPTCHA-Lösung mit solvethree

1. 1.

   Registrieren und Workspace einrichten

   Beginnen Sie bei der Registrierung. Verwenden Sie denselben Workspace für Ihren API-Schlüssel, Ihr Website-Profil und Ihr Guthaben.

2. 2.

   Schlüssel erstellen

   Öffnen Sie in der Konsole die API-Schlüssel. Wählen Sie „API-Schlüssel erstellen“, geben Sie einen Schlüsselnamen ein und wählen Sie dann „Schlüssel erstellen“.

3. 3.

   Geheimen Schlüssel speichern

   Kopieren Sie den unter „API-Schlüssel speichern“ angezeigten geheimen Schlüssel und speichern Sie ihn sicher, bevor Sie „Ich habe diesen Schlüssel gespeichert“ wählen. Mit „Präfixe anzeigen“ lässt sich der vollständige geheime Schlüssel später nicht wiederherstellen. Bewahren Sie den Schlüssel auf Ihrem Server auf, nicht im Browser-Code.

Das Willkommensguthaben beträgt $5. Wenn Sie Guthaben aufladen müssen, beträgt die Mindesteinzahlung $10. reCAPTCHA kostet $2.00 pro 1,000 Lösungen; ein Task mit dem Status ready wird berechnet, ein fehlgeschlagener Lösungsvorgang wird erstattet.

1. 1.

   Zielseite hinzufügen

   Öffnen Sie Website-Profile und wählen Sie „Website hinzufügen“. Geben Sie die HTTPS-Seiten-URL des Ziels ein und wählen Sie Enterprise v3.

2. 2.

   Erfassungsaktion festlegen

   Verwenden Sie die Aktion, die für den zu integrierenden Vorgang erforderlich ist. Das folgende Anfragebeispiel verwendet login; nutzen Sie dies daher nur, wenn es die tatsächliche Aktion des Ziels ist. Fügen Sie pro Hostname, Erfassungsaktion und reCAPTCHA-Typ ein Profil hinzu.

3. 3.

   Auf aktiven Status warten

   Wählen Sie „Website hinzufügen“. Bei einigen Konten wird zunächst „Guthaben aufladen, um fortzufahren“ angezeigt. Je nach Einreichung kann das Profil die Status Erfassung, Validierung oder Überprüfung durchlaufen. Fahren Sie erst fort, wenn es aktiv ist; eine bestimmte Erfassungsdauer ist nicht garantiert. Wenn die Erfassung fehlschlägt, lesen Sie vor einem erneuten Versuch die Begründung.

Das Senden eines Hostnamens und einer Aktion in einem Task erstellt kein Profil. Verwenden Sie für diesen ersten Lösungsvorgang im Task exakt die Erfassungsaktion des Profils. Informationen zu optionalen Feldern und zur Aktionsauswahl finden Sie unter Einrichtung von Website-Profilen.

Senden Sie den folgenden Body an POST https://api.solvethree.com/v1/tasks. Authentifizieren Sie sich über den Header Authorization mit Bearer, gefolgt von Ihrem Workspace-API-Schlüssel.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• Ersetzen Sie site durch den Zielhostnamen, nicht durch die vollständige Seiten-URL. Ersetzen Sie action durch die für Ihren ersten Lösungsvorgang gewählte Aktion.
• Ersetzen Sie proxy durch Ihre HTTP-Proxy-URL mit Zugangsdaten. Diese Anfrage verwendet einen Proxy; senden Sie nicht zusätzlich proxyCandidates.
• Wählen Sie eine requestId für diese logische Anfrage und bewahren Sie sie zusammen mit den übermittelten Eingaben auf. Zulässig sind 1–64 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche.
• Lassen Sie type und url weg. Wenn recaptchaType fehlt, verwendet die Anfrage standardmäßig Enterprise v3.

Eine vollständige Python-Implementierung finden Sie unter reCAPTCHA Enterprise in Python. Die Anfrage hier zeigt die Werte, die Sie zuerst vorbereiten müssen.

Bewahren Sie die bei der Erstellung zurückgegebene Task-ID auf. Rufen Sie den Task mit GET https://api.solvethree.com/v1/tasks/:id ab, ersetzen Sie dabei :id durch diese ID und verwenden Sie dieselbe Bearer-Authentifizierung.

• Prüfen Sie auf eine nicht erfolgreiche HTTP-Antwort, bevor Sie den Body als erfolgreiche Task-Antwort auslesen.
• Solange der Status pending oder solving ist, setzen Sie das Polling fort. Keiner dieser Status enthält eine verwendbare Lösung.
• Wenn der Status ready ist, beenden Sie das Polling und lesen Sie solution aus.
• Wenn der Status failed ist, beenden Sie das Polling und prüfen Sie errorCode und error. Der fehlgeschlagene Lösungsvorgang wird erstattet.

Eine Antwort mit dem Status ready hat diese Struktur. Diese Token- und Browser-Identitätswerte sind Platzhalter, keine tatsächlich verwendbare Lösung.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   Token senden, nicht die Task-ID

   Setzen Sie solution.token dort ein, wo das vorgesehene Ziel sein reCAPTCHA-Token erwartet. Prüfen Sie die ausgehende Anfrage, um sicherzustellen, dass sie nicht die Task-ID oder ein altes Token sendet.

2. 2.

   Zurückgegebene Browser-Identität verwenden

   Verwenden Sie für die Anfrage an das Ziel solution.userAgent und solution.secChUa zusammen mit demselben Proxy, der für diesen Lösungsvorgang angegeben wurde. Kombinieren Sie diese Werte nicht mit einer anderen Browser-Identität und übermitteln Sie das Token nicht an eine andere Ziel-URL.

3. 3.

   Antwort des Ziels prüfen

   Vergewissern Sie sich, dass das Ziel den vorgesehenen Vorgang akzeptiert hat. Ein Task mit dem Status ready bedeutet, dass solvethree eine Lösung generiert hat; dies garantiert nicht, dass das Ziel Ihre nachfolgende Anfrage akzeptiert.

Sorgen Sie dafür, dass das Ziel diese einzelne Anfrage akzeptiert, bevor Sie einen Batch starten. Wird sie abgelehnt, prüfen Sie das übermittelte Token, die Browser-Identität, den Proxy und die Ziel-URL, bevor Sie weitere Lösungen kaufen.