Menu dokumentasi

RecaptchaV3TaskProxyless: selesaikan Google Recaptcha v3

Jenis objek tugas ini dibutuhkan untuk menyelesaikan Google Recaptcha v3 di komputer pekerja. Tugas ini akan dikerjakan oleh layanan kami menggunakan server proxy kami sendiri dan/atau alamat IP pekerja.

Perhatikan bahwa ada perbedaan antara Recaptcha v2 invisible dan Recaptcha v3. Keduanya terlihat sama dan mungkin membingungkan. Ada cara cepat untuk menentukan jenis yang benar: coba selesaikan dengan API kami sebagai v2 invisible dan v3. Anda akan mendapatkan kode kesalahan untuk salah satu percobaan, sementara satunya tidak.

Kami menguji "skor" Recaptcha pekerja kami dan memasukkan mereka ke dalam 3 kelompok (antrean): 0,3; 0,7; dan 0,9. Setiap kelompok mungkin punya biaya yang sedikit berbeda karena jumlah pekerja yang menganggur. Dengan melewati properti minScore, Anda mendefinisikan antrean untuk tugas Anda. Sebagian besar pekerja yang menganggur punya skor 0,3, dan sedikit pekerja punya skor 0,9.

Informasi selengkapnya tentang Recaptcha v3 dapat ditemukan di bagian FAQ ini.

Contoh Recaptcha v3. Biasanya ada lencana logo di pojok kanan bawah halaman. Namun, ini bisa dengan mudah dihilangkan dengan JavaScript.

Objek tugas

Properti Jenis Wajib Tujuan
type String Ya RecaptchaV3TaskProxyless
websiteURL String Ya Alamat halaman web target. Dapat berada di mana pun di situs web, bahkan di area anggota. Pekerja kami tidak menjelajahinya, tetapi menyimulasikan kunjungan.
websiteKey String Ya Kunci situs web Recaptcha. Pelajari cara menemukannya dalam artikel ini.
minScore Double Ya Memfilter pekerja dengan skor yang dibutuhkan. Nilainya bisa salah satu dari berikut:
0,3
0,7
0,9
pageAction String Tidak
Nilai "action" Recaptcha. Situs web pemilik mendefinisikan apa yang dilakukan pengguna di halaman melalui parameter ini.
Contoh:

grecaptcha.execute('site_key', {action:'login_test'})
isEnterprise Boolean Tidak Atur penanda menjadi "true" jika Anda ingin v3 ini diselesaikan dengan API Enterprise. Nilai defaultnya adalah "false" dan Recaptcha diselesaikan dengan API non-Enterprise. Dapat ditentukan oleh panggilan JavaScript seperti dalam contoh berikut:

grecaptcha.enterprise.execute('site_key', {..})

Contoh permintaan

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"RecaptchaV3TaskProxyless",
            "websiteURL":"http://mywebsite.com/recaptcha/test.php",
            "websiteKey":"6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16",
            "minScore": 0.3,
            "pageAction": "myverify",
            "isEnterprise": false
        }
}' https://api.anti-captcha.com/createTask
        

Contoh respons

JSON tanpa kesalahan
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON dengan kesalahan
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

Dapatkan solusi

Gunakan metode getTaskResult untuk meminta solusi. Berikan waktu pada pekerja, sekitar 5 detik, sebelum membuat permintaan pertama. Jika pekerja masih sibuk, ulangi dalam 3 detik.

Objek solusi tugas

Properti Jenis Tujuan
gRecaptchaResponse String String token yang dibutuhkan untuk berinteraksi dengan formulir pengiriman di situs web target.

Contoh respons

JSON tanpa kesalahan
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}