驗證使用者回應('s)

本頁面說明如何從應用程式的 後端。

對於網頁使用者，您可以透過下列其中一種方式取得使用者的回應權杖：

• g-recaptcha-response 使用者在網站上提交表單時的 POST 參數
• 使用者完成 grecaptcha.getResponse(opt_widget_id) 後 reCAPTCHA 驗證問題
• 做為回呼函式的字串引數 如果在 g-recaptcha 標記屬性中指定了 data-callback，或 grecaptcha.render 方法中的回呼參數

如果是 Android 程式庫使用者，您可以呼叫 SafetyNetApi.RecaptchaTokenResult.getTokenResult() 方法，如果狀態傳回成功，就會取得回應權杖。

符記限制

每個 reCAPTCHA 使用者回應權杖的有效期限為 2 分鐘，而且只能驗證一次， 以防止重送攻擊如需新的權杖，您可以重新執行 reCAPTCHA 驗證。

取得回應權杖後，您必須在兩分鐘內，以 reCAPTCHA 使用 確認權杖有效。

API 要求

網址：https://www.google.com/recaptcha/api/siteverify 方法：POST

POST 參數	說明
secret	必要欄位。網站和 reCAPTCHA 之間的共用金鑰。
response	必要欄位。網站上 reCAPTCHA 用戶端整合提供的使用者回應權杖。
remoteip	選用設定。使用者的 IP 位址。

API 回應

回應是 JSON 物件：

{
  "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
}

reCAPTCHA 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
}

錯誤代碼參考資料

錯誤代碼	說明
missing-input-secret	缺少 Secret 參數。
invalid-input-secret	密鑰參數無效或格式錯誤。
missing-input-response	找不到回應參數。
invalid-input-response	回應參數無效或格式錯誤。
錯誤的要求	要求無效或格式錯誤。
逾時或重複	回應已失效：太舊或之前使用過。