Panduan
Tugas (Token)
reCAPTCHA v2

ReCaptchaV2: Menyelesaikan reCAPTCHA v2

TIP

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

Jenis tugas types yang kami dukung:

  • ReCaptchaV2Task jenis tugas ini memerlukan proxy Anda sendiri.
  • ReCaptchaV2EnterpriseTask jenis tugas ini memerlukan proxy Anda sendiri.
  • ReCaptchaV2TaskProxyLess menggunakan proxy internal server.
  • ReCaptchaV2EnterpriseTaskProxyLess 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
TypeStringRequiredReCaptchaV2Task
ReCaptchaV2TaskProxyLess
websiteURLStringRequiredAlamat web situs web yang menggunakan umumnya nilainya tetap. (Contoh: https://google.com)
websiteKeyStringRequiredKunci domain publik, jarang diperbarui. (Contoh: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxyStringOptionalPelajari Menggunakan proxy
pageActionStringOptionalBeberapa situs di ujung anchor memiliki parameter “sa”, ini adalah nilai tindakan
enterprisePayloadObjectOptionalMuat lanjutan Enterprise
isInvisibleBoolOptionaljika recaptcha tidak memiliki pageAction, flag konten permintaan reload memiliki “fi”
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": "ReCaptchaV2Task",
    //Diperlukan
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Diperlukan
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      //Opsional, diperlukan jika situs web menggunakan recaptcha enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    "isInvisible": false,
    // Opsional
    "pageAction": "submit",
    //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 dijelaskan di getTaskResult.

Tergantung pada be

ban sistem, Anda akan mendapatkan hasil dalam rentang 1 detik hingga 10 detik

Permintaan Contoh

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, //Waktu kadaluarsa token
        "gRecaptchaResponse": "3AHJ....." //Token solusi
    },
    "status": "ready"
}

Menggunakan Permintaan SDK

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