Panduan
Tugas (Token)
reCAPTCHA v3

ReCaptchaV3: Menyelesaikan reCAPTCHA v3

TIP

Buat tugas dengan metode createTask dan dapatkan hasilnya dengan metode getTaskResult.

Jenis tugas types yang kami dukung:

  • ReCaptchaV3Task jenis tugas ini memerlukan proxy Anda sendiri.
  • ReCaptchaV3EnterpriseTask jenis tugas ini memerlukan proxy Anda sendiri.
  • ReCaptchaV3TaskProxyLess menggunakan proxy internal server.
  • ReCaptchaV3EnterpriseTaskProxyLess menggunakan proxy internal server.

Buat Tugas

Buat tugas pengenalan dengan metode createTask.

Sebelum membuat tugas, Anda dapat mempelajari hal berikut

Jika Anda mendapatkan tanggapan yang tidak valid, Anda dapat mempelajari hal berikut

Struktur Objek Tugas

PropertiTipeDiperlukanDeskripsi
typeStringRequiredReCaptchaV3Task
ReCaptchaV3TaskProxyLess
websiteURLStringRequiredAlamat web situs web yang menggunakan umumnya nilainya tetap. (Contoh: https://google.com)
websiteKeyStringRequiredKunci domain publik, jarang diperbarui. (Contoh: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
pageActionStringRequiredNilai tindakan widget. Pemilik situs web menentukan apa yang dilakukan pengguna di halaman melalui parameter ini. Nilai default: verifikasi Contoh: grecaptcha.execute('site_key', {action:'login_test'}).
minScoreDoubleOptionalNilai dari 0.1 hingga 0.9.
proxyStringOptionalPelajari Menggunakan proxy
enterprisePayloadObjectOptionalPayload Enterprise
apiDomainStringOptionalAlamat domain dari mana untuk memuat reCAPTCHA Enterprise.
Contoh:
http://www.google.com/
http://www.recaptcha.net/
Jangan gunakan parameter ini jika Anda tidak tahu mengapa itu diperlukan.
userAgentStringOptionalUser-Agent Browser yang digunakan dalam emulasi. Diperlukan bahwa Anda menggunakan tanda tangan browser modern, jika tidak Google akan meminta Anda untuk “memperbarui browser Anda”.
cookiesArrayOptionalPelajari Menggunakan Cookies
anchorStringOptionalCara menghindari semua versi reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise dengan skor 0.9
reloadStringOptionalCara menghindari semua versi reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise dengan skor 0.9

Contoh Permintaan

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    //Diperlukan
    "type": "ReCaptchaV3Task",
    //Diperlukan
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Diperlukan
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    //Diperlukan
    "pageAction": "login",
    //Opsional
    "minScore": 0.7,
    "enterprisePayload": {
      //Opsional, diperlukan jika situs web menggunakan recaptcha enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    //Opsional
    "apiDomain": "",
    //Opsional
    "userAgent": "",
    //Opsional
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ],
    //Opsional                
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    //Opsional, Anda hanya perlu mengirimkan sekali dan mendapatkan hasilnya dengan berhasil, Anda dapat menghapus parameter ini
    "anchor": "konten base64",
    "reload": "konten base64"
  }
}

Setelah Anda mengirimkan tugas kepada kami, Anda seharusnya menerima ‘ID Tugas’ dalam tanggapan jika berhasil. Harap baca errorCode: daftar lengkap kesalahan jika Anda tidak menerima ID tugas.

Contoh Respons

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" 
}

Mendapatkan Hasil

Setelah Anda memiliki taskId, Anda perlu mengirimkan taskId untuk mendapatkan solusi. Struktur respons dij

elaskan di getTaskResult.

Tergantung pada beban sistem, Anda akan mendapatkan hasil dalam rentang 1 detik hingga 10 detik

Contoh Permintaan

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Contoh Respons

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", //User-Agent
        "expireTime": 1671615324290, //Kadaluarsa token
        "gRecaptchaResponse": "3AHJ....." //Token solusi
    },
    "status": "ready"
}

Gunakan Permintaan SDK

# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
 
import capsolver
 
# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-", ...
})