منوی مستندات

HCaptchaTask: HCaptcha را از طریق پروکسی حل می‌کند

hCaptcha کپچای "جایگزین پایین افتادنی ریکپچا" را صدا می‌زند. ما تلاش کردیم تا حالت مشابهی را در API خودمان ایجاد کنیم به‌صورتی که خصوصیات وظیفه به جز خصوصیت "type" کاملاً مشابه با RecaptchaV2Task باشند.

مهم: ظاهراً hCaptcha دارای محدودیت وظایف حل شده از یک IP است که این محدودیت تقریبا 3 بار در هر 12 ساعت است. وقتی فرایند حل از طریق پروکسی‌تان را ایجاد می‌کنید، این موضوع را در نظر بگیرید.

مثال Recaptcha V2

شیء وظیفه

خصوصیت نوع موردنیاز هدف
type رشته بله HCaptchaTask
websiteURL رشته بله آدرس صفحه وب هدف. می‌تواند در هرجایی در وب‌سایت حتی بخش اعضا قرار گرفته باشد. کارگران ما به آنجا نمی‌روند بلکه در عوض بازدید را شبیه‌سازی می‌کنند.
websiteKey رشته بله کلید سایت hCaptcha
proxyType رشته بله نوع پروکسی
http - پروکسی http/https معمولی
socks4 - پروکسی socks4
socks5 - پروکسی socks5
proxyAddress رشته بله آدرس IP پروکسی ipv4/ipv6. بدون نام میزبان یا آدرس IP از شبکه‌های محلی
proxyPort عدد صحیح بله درگاه(پورت) پروکسی
proxyLogin رشته خیر یوزرنیم برای پروکسی که نیاز به احراز هویت (پایه) دارد
proxyPassword رشته خیر پسورد پروکسی
userAgent رشته بله عامل کاربر مرورگر که در شبیه‌سازی استفاده می‌شود. لازم است که از امضای یک مرورگر مدرن استفاده کنید در غیر این صورت گوگل از شما درخواست خواهد کرد تا " مرورگرتان را آپدیت کنید "

نمونه درخواست

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "task":
        {
            "type":"HCaptchaTask",
            "websiteURL":"https://hcaptcha.com/",
            "websiteKey":"00000000-0000-0000-0000-000000000000",
            "proxyType":"http",
            "proxyAddress":"8.8.8.8",
            "proxyPort":8080,
            "proxyLogin":"proxyLoginHere",
            "proxyPassword":"proxyPasswordHere",
            "userAgent":"MODERN_USER_AGENT_HERE"
        }
}' https://api.anti-captcha.com/createTask
        

نمونه پاسخ

JSON بدون هیچ خطایی
          {
    "errorId": 0,
    "taskId": 7654321
}
        
JSON با یک خطا
          {
    "errorId": 1,
    "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
    "errorDescription": "Account authorization key not found in the system"
}
        

بازیابی راه‌حل

از متد getTaskResult برای درخواست راه‌حل استفاده کنید. قبل از این‌که درخواست اول را بفرستید، کمی به کارگر فرصت بدهید، مثلاً 5 ثانیه به او وقت بدهید. اگر کارگر همچنان شلوغ بود، 3 ثانیه بعد مجدداً تلاش کنید.

شیء راه‌حل وظیفه

خصوصیت نوع هدف
gRecaptchaResponse رشته رشته توکن که برای تعامل با فرم ارسال در وب‌سایت هدف لازم است.

نمونه پاسخ

JSON بدون هیچ خطایی
          {
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse":"3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
    },
    "cost":"0.001500",
    "ip":"46.98.54.221",
    "createTime":1472205564,
    "endTime":1472205570,
    "solveCount":"0"
}