استخدام البروكسي

متى تحل عبر البروكسي الخاص بك وكيف ترسله.

متى تحتاج إلى بروكسي

تقبل معظم المواقع رمزًا تم حله من عنوان IP آخر، لذا تعمل الأسماء بدون بروكسي لمعظم المهام. استخدم البروكسي الخاص بك عندما يتحقق الموقع من أن الرمز حُل من عنوان IP نفسه الذي يرسله، أو عندما يتطلبه النوع (DataDome، صفحة Cloudflare Challenge).

كيف ترسله

استخدم اسم نوع المهمة بدون Proxyless وأضف حقول البروكسي إلى المهمة. يمكنك إرسالها منفصلة أو كسلسلة proxy واحدة؛ تُقسم السلسلة تلقائيًا.

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass"
  }
}

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6LcR_RsTAAAAAFJR_5ZdbQd0SMxL7yIDmSXH1-lo",
    "proxy": "http://user:pass@1.2.3.4:8080"
  }
}

حقول البروكسي

proxyType

Stringمطلوب

http أو https أو socks4 أو socks5.

proxyAddress

Stringمطلوب

عنوان IP للبروكسي أو اسم المضيف.

proxyPort

Integerمطلوب

منفذ البروكسي.

proxyLogin

Stringاختياري

اسم مستخدم البروكسي، إن كان البروكسي يتطلبه.

proxyPassword

Stringاختياري

كلمة مرور البروكسي، إن كان البروكسي يتطلبها.

proxy

String

كل حقول البروكسي في سلسلة واحدة، مثلًا http://user:pass@1.2.3.4:8080.

معلومات مفيدة

يجب أن يكون البروكسي متاحًا من الإنترنت وأن يبقى يعمل أثناء تنفيذ المهمة.
إذا لم يتمكن الحلّال من الاتصال، تفشل المهمة بالخطأ ERROR_PROXY_CONNECTION_FAILED ويُسترد مبلغها.
غياب proxyAddress أو proxyPort في مهمة البروكسي يرجع ERROR_BAD_PROXY فورًا، مجانًا.
حقول البروكسي المرسلة مع اسم بدون بروكسي تُحذف.
بيانات البروكسي تُحذف عند انتهاء المهمة.