Recaptcha3 Protokoll Erkennungs-API Integrationsanleitung

Dieser Artikel beschreibt eine Integrationsanleitung für die Recaptcha3 Protokoll Erkennungs-API, die es Benutzern ermöglicht, die Recaptcha3 Verifizierung ohne Erkennung und Auswahl von Captcha-Bildern durch die einfache Einreichung des Website-Schlüssels im Hintergrund automatisch zu entschlüsseln und die Verifizierung abzuschließen.

Antragsprozess

Um die Recaptcha3 Protokoll Erkennungs-API zu verwenden, müssen Sie zunächst im Ace Data Cloud Dashboard Ihr API-Token abrufen und für zukünftige Verwendung aufbewahren.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, die Sie zur Registrierung und Anmeldung einlädt. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um alle Dienste der Plattform zu nutzen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr allgemeines Guthaben aufladen.

📘 Vollständige Dokumentation: Recaptcha3 Protokoll Erkennungs-API →

Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen. Im Vergleich zu Recaptcha2 müssen wir einen zusätzlichen Parameter page_action übergeben, der aus dem Code abgerufen werden muss. Die angezeigte URL für die Netzgeschwindigkeit lautet: https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php. Im Folgenden wird eine Methode zur Beschaffung gezeigt:

Schnelle Methode:

Öffnen Sie f12 und suchen Sie auf der Elementseite nach .execute(. Im roten Rahmenbereich können wir den action-Parameter sehen, und gleichzeitig folgt auf execute eine Zeichenfolge, die ebenfalls benötigt wird. Dies ist im folgenden Bild dargestellt.

Außerdem müssen Sie die URL der Website eingeben, die das Captcha verarbeitet, um das verarbeitete Ergebnis zu erhalten. Zunächst müssen Sie einfach ein website_url-Feld übergeben, und schließlich müssen Sie den Parameter website_key eingeben, der im obigen Text abgerufen werden kann und ebenfalls eine Zeichenfolge ist, die auf execute folgt. Wir können dann die entsprechenden Inhalte auf der Benutzeroberfläche ausfüllen, wie im Bild gezeigt:

Hier haben wir die Request-Header festgelegt, einschließlich:

accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
authorization: Der Schlüssel zur API-Nutzung, der nach der Beantragung direkt ausgewählt werden kann.

Zusätzlich haben wir den Request-Body festgelegt, einschließlich:

page_action: Muss im Code der Website, die das Captcha enthält, abgerufen werden.
website_url: Die URL der Website, die das Captcha verarbeitet.
website_key: Der Website-Schlüssel-Identifikator in Recaptcha3.

Nach der Auswahl können Sie feststellen, dass auf der rechten Seite der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie im obigen Bild gezeigt, haben wir das folgende Ergebnis erhalten:

{
  "token": "03AFcWeA5mfdNlQD0RGX9PTWPs0l65QukjwbYObCue5hygRuA6jJmBtwR98S2bmmZOjbLh7ogEMDd8NzJdq8DoHOD_LHIUWmdEL3HJS0pP2nmTTSoU_ltxORWA4sVsrWiXDgkARA4wAhJCegD6PftkRuu0KKbqRsJ7KVKukUbLU1ThBu7P3r0fybwpS11yQmF7xpbEZeFzRm_osERk9tQzs1lEYORZSVA5dimbWi42TqUC87mJHCKO0HMiU404LOyER84It7ne51V5YXEHR_o6-ORr2CmBOawdTDTsqWUwT8vyEvzy-ov-pZdl0B0A_U59_uZd7vbIwv937-iXyzkVWbakUXNMdXlHffpFYd7OLTSBhJu6nasV3IhrbnxO8eGIbPDoHIyGpA74D882ALwTnXMgkcmGeGM9YuqCrf7F06cNKY7yKiisZIU-7v3ZnHV3JUkODGpXQ6dwq2fuP5o6kgeUQVdkv4fAZ_Tx_TB_R6gPSgwulr8Q5hH34bs-v1oUl2S9mLhXT9SWvgYizU_4FN2Ou23ETXTAVD_uI9fWaDgKaLOKI1i-xHCF_LKU3wKjyYJfQhFSCSyoeGL4o1j9lZ27cEHL5AlCm_jcCiXhe2_LT_dI-r5ozuyOGv-iDZ_1XTSSnCGdmroXX56XsZAytU52zBAlYVe_aRAojruc9KdkhK4kdeBESBbDLVe3-jNFwYspe0R93SORxXXIqR9CtZrIjI_2U8XjCHFz_euChdU_wkH5BjvONVbUT1DQNuoo0ugJL5kUkFrubHppOKvoZMwIKjjK_ZX1NBeCvQvYm6IpwBWfvM4hjGI7UVXH3iZkrX9PLATIIIkA8PxTeN45k8DulzOhKLSFKK196fRlH83S8UAaM-vjBxf32Vg83C1gWzKB5sYhxqEtZeB7DNpmAkozFfubljURr7YTjtq8Bgnj0PkfzbgKk8FRl-hMUb9BUjNNuSuFC7GZVim6xQnIV9ZPaAcuzJTYcOizFJePbVEXlc9A5Vq2rDh3D7Ld5o5oqc2kK4eCrO_38le6EVTs_fRY2nXy6RMyjjaJN12lOKYwYzGKhm52gTZTrJXqeTAW8o2KfwZ9iek-tr5qxj5b40iY4V2PY6SflMQvmKLAgFhB-yo-o5PEkikQ98T-bE-wG2-3kd5NRMiD132kIhf48zhVJUGeJqdV_3m8ukyqTk26KisM12kN-h9uYefvUCxzd_mBuWlHzH9rFMlJSe8Z6lcZIVcqNF4fcEM-ukNnwMUK5H_SC48U7O_xfOaEqEpAHDC7CCyVwlGCFh0uAT8KSpaNFfxBmMPXeYrGYn83PCgMg1NZA-7PrpeidXmWdBZ2yY8MA__7uCe8clCmINseBTCIbNmAHPlI_zJKqQfhXaDbaELeD62P0Pquu_SBtdEtqPeB9Esn_yjbK3IFvAaGSnFhwhHHK8dpOI7v-rJvTigPu8MMrEUTvug_zog81kCG8HY3xorTj2OdTwdEYpeMJ1VIHSjdTcnepLB0Cffx5wAdk-gf1TGEnEyTiwII4A4vtq8r0LFK4YObOzNmBTl3IoTNheYYKpheTKH3KShMK6hXDKxDRGEUhdsW4TRtVT-dwJDqY_F7J1RwKP-xDuN98VgwQmQuhJteQUALevgI2jAGFCFfSeFbQ8BOT6ekEI0m30zDX0kh83mkE7-u9qKljYifjqbLarMNPP51QRbvAS3mHlP17PMhIKzjuIka4T2Y9XdRwDgRRdEkYiJgDvkcABTknGBMezraon8JNDRhIJMUIKpidWTdhEQ79qAEfZkowdbnTdKeWeayi1OmV_W4aox-aC62H-VIn70McXXB6zRyYlA2NvTUWgNhHWkSO1SW7uflNEyUeWFRLBZV_firMEVfIGirHOAbQqsn83BirDNPHl4xevf4nRu4gWpgOGBrzeUXQeuMWO4ZFsdWxJ2VsT19t0H5DJtxtHYXFtPZ8tFDFY-r8JKFab4S6e5v8PCrfjCWkPmDaRJal_vLFa1V1dF1l0ARu9NLW4mEuT600azFms8cMlvuCTvWI2VWyn4Wk05UvcR8FYO2-ke4E-ZFRl0jSxjlEutzbOwm2ik4eF0Wh2DBliaSr1obHaxkmLJDUIzGQ3wi49Nyn0SSOdz_BGaxuRrrxCZ4ci0e2b5cxLtkv64Njy7IYJURaBuQk99ijdw7rg3pssAa_uJSMQeZe_kLtgEWF73uT4ceSOFPVuxMGLrJRQTBYxAHVKq7kloS5wtphUr2Sp-b4kezKnCV9HNfC5NRk2KqDT-bkJ6cUYN_0yauyZK1_F4BVTk36IOCe1Cqfe3K-wAZBzvrI_Vz8Li1uEWe0b5KOQ",
  "elapsed": 31.6
}

Die Rückgabe enthält mehrere Felder, die wie folgt beschrieben werden:

token, das Ergebnis der Verarbeitung der Recaptcha3-Verifizierung.
started_at, finished_at: Die Zeit, zu der die Anfrage bearbeitet und das Ergebnis erzeugt wurde, Unix-Zeitstempel (Sekunden, Fließkomma).
elapsed: Die gesamte Bearbeitungszeit (Sekunden).

Wir können sehen, dass wir das Verifizierungsergebnis für die Verarbeitung des Recaptcha3 erhalten haben, das wir dann für POST- oder GET-Anfragen an die Zielwebsite verwenden können, einmalig nutzbar, gültig für 120 Sekunden, empfohlen innerhalb von 60 Sekunden zu verwenden. Im Folgenden wird eine Möglichkeit beschrieben, wie das generierte Token an die Zielwebsite übermittelt werden kann: Aufruf des Python-Codes zur Tokenverifizierung:

import requests

url = "https://recaptcha-demo.appspot.c/recaptcha-v3-verify.php?action=examples/v3scores&token='{token}'"

r = requests.get(url)
if r.status_code == 200:
    return r.text

Daher können wir das Ergebnis erhalten:

{
  "success": true,
  "hostname": "recaptcha-demo.appspot.com",
  "challenge_ts": "2024-09-14T08:52:26Z",
  "apk_package_name": null,
  "score": 0.9,
  "action": "examples/v3scores",
  "error-codes": []
}

可以看到，其中 success 表示此处验证的处理结果，所有我们成功通过Recaptcha3验证码的验证。另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

curl -X POST 'https://api.acedata.cloud/captcha/token/recaptcha3' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "website_url": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
  "website_key": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
  "page_action": "examples/v3scores"
}'

Python 的对接代码如下：

import requests

url = "https://api.acedata.cloud/captcha/token/recaptcha3"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "website_url": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
    "website_key": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
    "page_action": "examples/v3scores"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Asynchroner Modus (async)

Standardmäßig ist die API synchron blockierend: Eine Anfrage wartet, bis die Token-Verarbeitung abgeschlossen ist, bevor sie zurückgegeben wird. Wenn Sie eine Multi-Solver-Rotation durchführen und „nach dem Einreichen der Aufgabe sofort die task_id erhalten möchten, um andere Solver zu planen und später zurückzukehren, um die Ergebnisse abzurufen“, können Sie async: true im Anfragekörper übergeben. Nach der Übergabe von async: true gibt die Schnittstelle sofort eine task_id zurück, ohne zu blockieren:

curl -X POST 'https://api.acedata.cloud/captcha/token/recaptcha3' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "website_url": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
  "website_key": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
  "page_action": "examples/v3scores",
  "async": true
}'

{
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002",
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

Um den Fortschritt aktiv zu überprüfen, können Sie die task_id verwenden, um POST /captcha/tasks abzufragen (empfohlen alle 3-5 Sekunden). Diese Schnittstelle löst keine Aufgabenverarbeitung aus oder beschleunigt sie; selbst wenn Sie nicht abfragen, die Verbindung unterbrochen wird oder der Client beendet wird, wird der Server weiterhin verarbeiten:

curl -X POST 'https://api.acedata.cloud/captcha/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002"
}'

Während der Verarbeitung wird status: processing zurückgegeben:

{ "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "processing" }

Nach Abschluss der Verarbeitung wird status: ready und das Token zurückgegeben:

{
  "success": true,
  "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002",
  "status": "ready",
  "token": "03AFcWeA5mfdNlQD0RGX9PTWPs0l65QukjwbYObCue5hygRuA6......"
}

Abrechnungsinformationen: Im asynchronen Modus werden die Erstellung von Aufgaben und das Abrufen des „verarbeiteten“ Status nicht berechnet; der Client wird einmal berechnet, wenn er das erste erfolgreiche Ergebnis abruft (entspricht dem bestehenden Verhalten und den Preisen im synchronen Modus). Der Server wird die Aufgaben selbstständig vorantreiben, aber es wird keine vorzeitige Abrechnung geben, nur weil die Verarbeitung im Hintergrund abgeschlossen ist. Wenn die Aufgabe innerhalb von 120 Sekunden nicht erfolgreich ist, wird sie mit HTTP 504 timeout beendet, ohne berechnet zu werden. /captcha/tasks ist nicht verantwortlich für die Vorantreibung von Aufgaben.

Fehlerbehandlung

Wenn beim Aufruf der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen zurück. Zum Beispiel:

400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
401 invalid_token: Unbefugt, ungültiger oder fehlender Autorisierungstoken.
429 too_many_requests: Zu viele Anfragen, Sie haben das Kontingent überschritten.
500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.

Fehlerantwort Beispiel

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Fazit

Durch dieses Dokument haben Sie gelernt, wie Sie die Recaptcha3-Protokoll-Identifikations-API verwenden, damit Benutzer die Recaptcha3-Bilder nicht erkennen und anklicken müssen, sondern lediglich durch die Einreichung des Website-Schlüssels die automatische Dekodierung im Hintergrund durchführen können, um die Validierung abzuschließen. Wir hoffen, dass dieses Dokument Ihnen hilft, die API besser zu integrieren und zu nutzen. Bei Fragen wenden Sie sich bitte jederzeit an unser technisches Support-Team.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Proxy

Erweitert

Coding

Recaptcha3 Protokoll Erkennungs-API Integrationsanleitung

Antragsprozess

Grundlegende Nutzung

Schnelle Methode:

Asynchroner Modus (async)

Fehlerbehandlung

Fehlerantwort Beispiel

Fazit

​Antragsprozess

​Grundlegende Nutzung

​Schnelle Methode:

​Asynchroner Modus (async)

​Fehlerbehandlung

​Fehlerantwort Beispiel

​Fazit

Antragsprozess

Grundlegende Nutzung

Schnelle Methode:

Asynchroner Modus (async)

Fehlerbehandlung

Fehlerantwort Beispiel

Fazit