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
pageActionStringOptionalUntuk situs v2: jika ada parameter sa dalam permintaan anchor, lewatkan parameter
Untuk situs v3: Cari grecaptcha.execute untuk menemukan parameter action
enterprisePayloadObjectOptionalEnterprise versi pencarian grecaptcha.enterprise.render, memberikan parameter s di dalamnya
isInvisibleBoolOptionalTidak ada kotak centang “Saya bukan robot”, tetapi jika ada tantangan, silakan kirimkan true, biasanya diperlukan dalam mode stealth v2
isSessionBoolOptionalMode 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.
apiDomainStringOptionalMemuat 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": "ReCaptchaV2Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "isInvisible": false, // 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 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
        "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"
}

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-",
          })