Bermigrasi ke API v1

Dokumen ini menunjukkan cara bermigrasi dari versi v1beta1 ke versi v1 reCAPTCHA Enterprise API.

Mulai Juni 2026, endpoint v1beta1 akan dihentikan secara bertahap. > Selama penghentian bertahap ini, permintaan yang dibuat ke endpoint v1beta1 dari layanan yang belum dimigrasikan akan mulai menampilkan error.

Untuk memigrasikan panggilan penilaian dari v1beta1 ke v1, lakukan hal berikut:

1. Ganti panggilan untuk membuat penilaian.

   Ganti https://recaptchaenterprise.googleapis.com/v1beta1/projects/PROJECT_ID/assessments?key=API_KEY dengan https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments?key=API_KEY

2. Pahami perubahan dalam respons JSON penilaian:

   Saat Anda menggunakan v1, kolom reasons dan score dienkapsulasi dalam riskAnalysis dalam respons, dan saat Anda menggunakan v1beta1, kolomreasons dan score tidak dienkapsulasi dalam respons.

   v1

   {
   "event":{
     "expectedAction":"EXPECTED_ACTION",
     "hashedAccountId":"ACCOUNT_ID",
     "siteKey":"KEY_ID",
     "token":"TOKEN",
     "userAgent":"(USER-PROVIDED STRING)",
     "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
   },
   "name":"ASSESSMENT_ID",
    "riskAnalysis":{
     "reasons":[],
     "score":"SCORE
   },
   "tokenProperties":{
     "action":"USER_INTERACTION",
     "createTime":"TIMESTAMP",
     "hostname":"HOSTNAME",
     "invalidReason":"(ENUM)",
     "valid":(BOOLEAN)
   }
   }