Warum solvethree ein Website-Profil statt eines websiteKey-Felds verwendet
solvethree speichert den reCAPTCHA-Websiteschlüssel und die Seitenkonfiguration in einem Websiteprofil. Die Aufgabenanfrage übermittelt den Hostnamen in site, die Ausführungsaktion in action und einen Proxy – nicht websiteKey oder websiteURL.
Wenn Sie von einer anderen API migrieren, reicht es nicht aus, Felder umzubenennen. Richten Sie zuerst ein aktives Profil in Ihrem Workspace ein; das Senden eines Hostnamens, einer Aktion oder eines Websiteschlüssels erstellt keines.
Auf dieser Seite
Websiteschlüssel und Seite in der Konsole konfigurieren
- 1.
„Website hinzufügen“ öffnen
Öffnen Sie Websiteprofile und wählen Sie „Website hinzufügen“. Geben Sie die HTTPS-Seiten-URL des Ziels ein. Die Aufgabe verwendet deren Hostnamen, nicht die vollständige URL. Geben Sie bei Bedarf die optionale Navigations-URL und den Referer-Wert für die Seitenkonfiguration an.
- 2.
Typ auswählen und Websiteschlüssel prüfen
Wählen Sie Enterprise v3 für eine reCAPTCHA-Enterprise-Integration oder Regular v3 für reguläres reCAPTCHA v3. Das Formular kann den Websiteschlüssel automatisch ermitteln; im optionalen Feld „Websiteschlüssel“ können Sie einen abweichenden Wert angeben.
- 3.
Erfassungsaktion festlegen
Die Erfassungsaktion ist erforderlich. Konfigurieren Sie für die folgende Anfrage ein Profil mit der Erfassungsaktion
login. Geprüfte Systemprofile können die bekannte Seitenkonfiguration und Erfassungsaktion ohne Live-Abruf ausfüllen; lesen Sie die Erklärung des Formulars zur gewählten Aktion. - 4.
Absenden und auf die Aktivierung warten
Wählen Sie „Website hinzufügen“. Einreichungen können vor der Aktivierung die Zustände „In Warteschlange“, „Erfassung“, „Validierung“ oder „Prüfung“ durchlaufen; eine bestimmte Erfassungsdauer wird nicht garantiert. Bei einigen Konten wird „Guthaben hinzufügen, um fortzufahren“ angezeigt. Falls die Erfassung fehlschlägt, prüfen Sie vor einem erneuten Versuch den Grund.
Verwenden Sie je ein Profil pro Hostname, Erfassungsaktion und reCAPTCHA-Typ. Eine exakt übereinstimmende Ausführungsaktion wählt das zugehörige Profil aus. Andere Ausführungsaktionen erfordern ein eindeutig bestimmbares Erfassungsziel. Gehen Sie daher nicht davon aus, dass ein einzelnes Profil für einen Hostnamen jede Aktion abdeckt.
Die flache Aufgabenanfrage senden
Sobald das Profil aktiv ist, senden Sie dieses Objekt direkt als JSON-Body an POST /v1/tasks. Authentifizieren Sie sich mit Authorization: Bearer, gefolgt vom API-Schlüssel Ihres Workspaces, und bewahren Sie diesen Schlüssel auf dem Server auf.
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteist der Hostname: ohne Schema, Pfad oder Abfrageparameter. Die vollständige Seiten-URL gehört in das Konsolenprofil.actionist die Ausführungsaktion für diese Aufgabe. Hier stimmtloginmit der oben konfigurierten Erfassungsaktion überein.proxygibt den Proxy für die Lösung an. Genau eines der FelderproxyoderproxyCandidatesist erforderlich; senden Sie nicht beide.requestIdist optional. Wenn beim Erstellen eine Zeitüberschreitung auftritt, gibt das erneute Senden derselben Anfrage mit derselben ID die bestehende Aufgabe zurück. Geänderte Aufgabeneingaben bei Wiederverwendung dieser ID führen zu einem Konflikt.
Übernehmen Sie websiteKey, websiteURL, type oder url nicht aus der Anfragestruktur der vorherigen API. Für reCAPTCHA ist enterprise-v3 der Standardwert von recaptchaType, weshalb das Beispiel dieses Feld auslässt. Für reguläres v3 wird recaptchaType auf v3 gesetzt.
Quellen und API-Referenz
Führe deinen ersten Task aus.
Starte mit $5 Workspace-Guthaben.