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
Properti | Tipe | Diperlukan | Deskripsi |
---|---|---|---|
type | String | Required | ReCaptchaV3Task ReCaptchaV3TaskProxyLess |
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) |
pageAction | String | Required | Nilai 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'}) . |
minScore | Double | Optional | Nilai dari 0.1 hingga 0.9. |
proxy | String | Optional | Pelajari Menggunakan proxy |
enterprisePayload | Object | Optional | Payload Enterprise |
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": "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-", ...
})