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

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	`ReCaptchaV3Task` `ReCaptchaV3TaskProxyLess` `ReCaptchaV3EnterpriseTask` `ReCaptchaV3EnterpriseTaskProxyLess`
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	Untuk situs v2: jika ada parameter sa dalam permintaan anchor, lewatkan parameter Untuk situs v3: Cari `grecaptcha.execute` untuk menemukan parameter action
enterprisePayload	Object	Optional	Enterprise versi pencarian `grecaptcha.enterprise.render`, memberikan parameter s di dalamnya
isSession	Bool	Optional	Mode sesi, jika diaktifkan, mengembalikan nilai `recaptcha-ca-t` yang digunakan sebagai cookie, biasanya muncul dalam v3 Catatan: Beberapa situs web membutuhkan nilai `recaptcha-ca-e` yang biasanya muncul dalam v2, dan jika ada, nilai ini akan dikembalikan secara otomatis dan tidak memerlukan pengaturan parameter tambahan.
apiDomain	String	Optional	Memuat nama domain dengan kode verifikasi, biasanya tidak perlu melewati parameter ini • http://www.google.com/ • http://www.recaptcha.net/

WARNING

Jika Anda tidak tahu bagaimana harus memberikan parameter, silakan lihat blog kami Menggunakan ekstensi capsolver untuk mendapatkan parameter secara otomatis.

Jika Anda menemukan nilai token yang lebih rendah, kirimkan data json yang diperoleh oleh ekstensi ke layanan pelanggan untuk dioptimalkan.

Contoh Permintaan

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV3Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "pageAction": "submit", // Optional
    "apiDomain": "", // Optional
    "proxy": "http:ip:port:user:pass", // socks5:ip:port:user:pass, Optional
  }
}

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
        "createTime": 1671615324290, // Waktu pembuatan token
        "gRecaptchaResponse": "3AHJ......", // token
        "recaptcha-ca-t": "AbEM......", // Beberapa situs v3 memiliki mode sesi, dan parameter ini dikembalikan ketika isSession diaktifkan untuk digunakan sebagai cookie.
        "recaptcha-ca-e": "Abp_......" // Beberapa situs v2 memiliki parameter ini, yang digunakan sebagai cookie dan akan dikembalikan secara otomatis jika ada.
    },
    "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-", ...
})

reCAPTCHA v2 MTCaptcha