Bewertung erstellen

Auf dieser Seite erfahren Sie, wie Sie das reCAPTCHA-Antworttoken eines Nutzers im Back-End Ihrer Anwendung bewerten.

Für Webnutzer können Sie das Antworttoken des Nutzers auf eine der folgenden Arten abrufen:

  • Der aufgelöste Wert, der durch den Aufruf von grecaptcha.execute zurückgegeben wird
  • POST-Parameter für g-recaptcha-response, wenn der Nutzer das Formular auf Ihrer Website abschickt
  • 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

Jedes reCAPTCHA-Antworttoken eines Nutzers von kann nur einmal bewertet werden. Wenn Sie eine nachfolgende Aktion bewerten müssen, die der Nutzer auf Ihrer Website ausführt, oder wenn ein Token abläuft, bevor eine Bewertung erstellt werden kann, müssen Sie grecaptcha.execute() noch einmal aufrufen, um ein neues Token zu generieren.

API-Anfrage

Erstellen Sie eine Bewertung mit der Methode projects.assessments.create.

curl \
  -X POST \
  -H "Content-Type: application/json"  \
  "https://recaptchaenterprise.googleapis.com/v1beta1/projects/[PROJECT_ID]/assessments?key={YOUR_API_KEY}" \
  -d "{'event': {'token': 'RESPONSE_TOKEN', 'siteKey': 'RECAPTCHA_SITE_KEY'}}"

Bei einer erfolgreichen Abfrage liefert der Server den HTTP-Statuscode 200 OK und die Antwort im JSON-Format:

{
  'tokenProperties': {
    'valid': True,
    'hostname': 'www.google.com',
    'action': 'homepage',
    'createTime': u'2019-03-28T12:24:17.894Z'
   },
  'score': 0.1,
  'reasons': ['AUTOMATION'],
  'event': {
    'token': 'RESPONSE_TOKEN',
    'siteKey': 'SITE_KEY'
   },
  'name': u'projects/[PROJECT_ID]/assessments/b6ac310000000000'
}

Ausführliche Informationen finden Sie unter Interpretieren der Bewertung