Antwort des Nutzers überprüfen

Auf dieser Seite wird erläutert, wie Sie die Antwort eines Nutzers auf eine reCAPTCHA-Abfrage über das Back-End.

Webnutzer haben drei Möglichkeiten, das Antworttoken des Nutzers abzurufen:

• g-recaptcha-response POST-Parameter, wenn der Nutzer das Formular auf Ihrer Website sendet
• grecaptcha.getResponse(opt_widget_id), nachdem der Nutzer fertig ist reCAPTCHA-Aufgabe
• Als Stringargument für Ihre Callback-Funktion, wenn data-callback entweder im g-recaptcha-Tagattribut oder im Callback-Parameter in der Methode grecaptcha.render angegeben ist

Nutzer der Android-Bibliothek können die SafetyNetApi.RecaptchaTokenResult.getTokenResult() -Methode zum Abrufen des Antworttokens, wenn der Status erfolgreich ist.

Tokeneinschränkungen

Jedes reCAPTCHA-Nutzerantworttoken ist zwei Minuten lang gültig und kann nur einmal bis zum Replay-Angriffe verhindern können. Wenn Sie ein neues Token benötigen, können Sie die reCAPTCHA-Überprüfung noch einmal ausführen.

Nachdem Sie das Antworttoken erhalten haben, müssen Sie es innerhalb von zwei Minuten mit reCAPTCHA bestätigen. Verwenden Sie dazu den folgenden API verwenden, um sicherzustellen, dass das Token gültig ist.

API-Anfrage

URL: https://www.google.com/recaptcha/api/siteverify

METHODE: POST

API-Antwort

Die Antwort ist ein JSON-Objekt:

{
  "success": true|false,
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "hostname": string,         // the hostname of the site where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

Für reCAPTCHA für Android:

{
  "success": true|false,
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "apk_package_name": string, // the package name of the app where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

Fehlercode-Referenz