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

Cara menemukan fungsi callback dari setiap versi reCaptcha

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

Cara menghindari semua versi reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise dengan skor 0.9

Struktur Objek Tugas

Properti	Tipe	Diperlukan	Deskripsi
Type	String	Required	`ReCaptchaV2Task` `ReCaptchaV2TaskProxyLess`
websiteURL	String	Required	Alamat web situs web yang menggunakan umumnya nilainya tetap. (Contoh: https://google.com)
websiteKey	String	Required	Kunci domain publik, jarang diperbarui. (Contoh: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxy	String	Optional	Pelajari Menggunakan proxy
pageAction	String	Optional	Beberapa situs di ujung anchor memiliki parameter “sa”, ini adalah nilai tindakan
enterprisePayload	Object	Optional	Muat lanjutan Enterprise
isInvisible	Bool	Optional	jika recaptcha tidak memiliki pageAction, flag konten permintaan reload memiliki “fi”
isSession	Bool	Optional	Mode sesi, saat diaktifkan, akan mengembalikan nilai `recaptcha-ca-t`, yang akan digunakan sebagai cookie
apiDomain	String	Optional	Alamat 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.
userAgent	String	Optional	User-Agent Browser yang digunakan dalam emulasi. Diperlukan bahwa Anda menggunakan tanda tangan browser modern, jika tidak Google akan meminta Anda untuk “memperbarui browser Anda”.
cookies	Array	Optional	Pelajari Menggunakan Cookies
anchor	String	Optional	Cara menghindari semua versi reCAPTCHA Enterprise v2, v2 invisible, v3, v3 enterprise dengan skor 0.9
reload	String	Optional	Cara 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
        "recaptcha-ca-t": "AbEM......" // Beberapa situs web memiliki mode sesi. Setelah mengaktifkan isSession, parameter ini akan dikembalikan dan digunakan sebagai cookie
    },
    "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-",
          })

Geetest reCAPTCHA v3