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 گرفته می‌شوند. |
| screenshots | آرایه | تصاویر گرفته شده از مرورگر کارگر، در صورت وجود. برای سفارش اسکرین شات، مرحله TAKE_SCREENSHOT را به الگوی خود اضافه کنید. |
| requestHeaders | آرایه | در صورت وجود، هدرها را از "domainsOfInterest" درخواست کنید. برای سفارش سرصفحه‌ها، گزینه «جمع‌آوری درخواست سرصفحه HTTP از دامنه‌های مورد علاقه» را در قالب خود فعال کنید. |
| responseHeaders | آرایه | هدرهای پاسخ از «domainsOfInterest»، در صورت وجود. برای سفارش سرصفحه‌ها، گزینه «جمع‌آوری سرصفحه‌های HTTP پاسخ از دامنه‌های مورد علاقه» را در قالب خود فعال کنید. |
نمونه پاسخ
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"
}
},
"screenshots": [],
"requestHeaders": [],
"responseHeaders": []
},
"cost": "0.00858",
"ip": "5.25.11.114",
"createTime": 1637841143,
"endTime": 1637841189,
"solveCount": 0
}