خانه مستندات خودآموزها ورود
انواع وظیفه مورد پشتیبانی
متدهای API
مقالات
خودآموزها
GitHub
منوی مستندات

AntiGateTask: آخرین راه برای گذشتن از هرنوع کپچای محافظ

در این نوع وظیفه‌، اپلیکیشن‌تان آدرس یک صفحه اینترنتی را فراهم می‌کند و برای کارگران ما تکلیفی سفارشی می‌سازد. آن‌ها این وظیفه را مرحله به مرحله تکمیل می‌کنند. سپس، اثر انگشت و کوکی‌های کامل مرورگرشان را به اپلیکیشن شما بازمی‌گردانند تا بتواند نشست را با آن‌ها ادامه دهد.

برای توضیح کامل این تکنولوژی به این مقاله مراجعه کنید.

در نظر داشته باشید که بسته به انتخاب شما، پارامترهای پراکسی هم وجود دارند. فقط پراکسی‌های HTTPS قبول می‌شوند. بخش «proxyAddress» باید یک آدرس IP باشد.

شیء وظیفه

خصوصیت نوع موردنیاز هدف
type رشته بله AntiGateTask
websiteURL رشته بله آدرس صفحه‌ی اینترنتی هدف که کارگر ما به آن خواهد رفت.
templateName رشته بله نام یکی از قالب‌های سناریو از پایگاه داده‌ی ما. شما می‌توانید از یکی از قالب‌های آماده استفاده کنید یا این که قالب خودتان را بسازید. شما می‌توانید پایین این جدول، در میان قالب‌های موجود به دنبال یک قالب بگردید.
variables شیء بله شی‌ای که حاوی متغیرها و مقادیرشان است.
domainsOfInterest آرایه خیر List of domain names where we should collect cookies and localStorage data. This list can also be defined statically when editing template.
proxyAddress رشته خیر آدرس IP پروکسی ipv4/ipv6. بدون نام میزبان یا آدرس IP از شبکه‌های محلی
proxyPort عدد صحیح خیر درگاه(پورت) پروکسی
proxyLogin رشته خیر یوزرنیم برای پروکسی که نیاز به احراز هویت (پایه) دارد
proxyPassword رشته خیر پسورد پروکسی

جمع کردن قالب‌ها


نام و شرح قالب
هیچ قالبی با کوئری شما پیدا نشد
وظیفه با یک پراکسی
          Click "view" button at one of the templates
        
وظیفه بدون پراکسی
          Click "view" button at one of the templates
        
مراحل قالب
          
        
مخاطبین نویسنده

نمونه پاسخ

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 ثانیه بعد مجدداً تلاش کنید.

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

خصوصیت نوع هدف
cookies شیء شی‌ای که کوکی‌هایش، در صفحه‌ی آخری که کارگر دیده است وجود داشته باشند.
localStorage شیء شی‌ای که مقادیر localStorage را داشته باشد، مثل کوکی‌ها در صفحه‌ی آخر بگیرید.
fingerprint شیء پارامترهای اثر انگشت مرورگر. برای بازسازی نشست مرورگر کارگر در نرم‌افزار خودتان، از این پارامترها به همراه کوکی‌ها و localStorage استفاده کنید.
url رشته آدرس صفحه‌ای که ویرایش قالب در آن تمام شده است
domain رشته نام دامنه‌ی صفحه‌ی نهایی
HTMLsInBase64 آرایه آرایه ای از عکس های فوری HTML از مناطق صفحه که در base64 کدگذاری شده اند. عکس‌های فوری با مراحل «TAKE_HTML_SNAPSHOT_BY_SELECTOR» در قالب‌های AntiGate گرفته می‌شوند.

نمونه پاسخ

JSON بدون هیچ خطایی
          {
    "errorId": 0,
    "status": "ready",
    "solution": {
        "cookies": {
            "_ym_uid": "1637841149407895406",
            "_ym_d": "1637841149",
            "_ym_isad": "2",
            "i18n_redirected2": "en"
        },
        "localStorage": {
            "_ym40786994_lsid": "322553582843",
            "_ym40786994_reqNum": "3",
            "_ym_fip": "\"65aac1083a9e31e5db7fc4a33816f1da-a81f3b9bcdd80a361c14af38dc09b309-a81f3b9bcdd80a361c14af38dc09b309-4bd84c89c35a312599d807af285e7b5f-615e6e8d95ae2de0910b550b0e4dfce2-00b2e6de4e7f2e69dd7de8ef95c7338a-61b9878bbce18de73aafc8582a198c0c-33ad8703f96139d946191563a4c623e6-a81f3b9bcdd80a361c14af38dc09b309-c6d7b47b2dcff33f80cab17f3a360d0b-a95e7098ce4ab7ec9daa7fb4154b8ff4\"",
            "_ym_retryReqs": "{}",
            "_ym40786994_lastHit": "1637841164076",
            "_ym_uid": "\"1637841149407895406\""
        },
        "fingerprint": {
            "self.navigator.userAgent": "Mozilla\/5.0 (Windows NT 6.3; Win64; x64; rv:94.0) Gecko\/20100101 Firefox\/94.0",
            "self.screen.width": 1280,
            "self.screen.height": 768,
            "self.screen.availWidth": 1280,
            "self.screen.availHeight": 728,
            "self.screen.availLeft": 0,
            "self.screen.availTop": 0,
            "self.navigator.vendorSub": "",
            "self.navigator.productSub": "20100101",
            "self.navigator.vendor": "",
            "self.navigator.maxTouchPoints": 0,
            "self.navigator.hardwareConcurrency": 2,
            "self.navigator.cookieEnabled": true,
            "self.navigator.appCodeName": "Mozilla",
            "self.navigator.appName": "Netscape",
            "self.navigator.appVersion": "5.0 (Windows)",
            "self.navigator.platform": "Win32",
            "self.navigator.product": "Gecko",
            "self.navigator.language": "en-US",
            "self.navigator.onLine": true,
            "self.navigator.doNotTrack": "unspecified"
        },
        "url": "https:\/\/anti-captcha.com\/tutorials\/success-page?login=some%20login&pass=the%20password",
        "domain": "anti-captcha.com",
        "domainsOfInterest": {
            "any-other-domain.com": {
                "cookies": {
                    "example": "value",
                    "comment": "This will be available when you fill a list of Domains Of Interest in the template itself or via domainsOfInterest parameter in the task object"
                },
                "localStorage": {
                    "example": "localStorage value"
                },
                "url": "https://any-other-domain.com/some/path",
                "domain": "any-other-domain.com"
            }
        }
    },
    "cost": "0.00858",
    "ip": "5.25.11.114",
    "createTime": 1637841143,
    "endTime": 1637841189,
    "solveCount": 0
}