# إعادة استخدام proxy عبر عدة requests

> URL: https://foura.ai/ar/docs/how-to/reuse-a-proxy
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

تعلم كيفية الاحتفاظ بنفس مخرج الـ proxy عبر الطلبات اللاحقة، بحيث تصدر عمليات معالجة JavaScript واستدعاءات API والصفحات المتتالية من نفس عنوان IP.

## لماذا تعيد استخدام Proxy

عند إرسال طلب إلى هدف لأول مرة، تختار FourA مخرج proxy صالحا لك. تتضمن استجابة Proxy أو Auto معرف proxy ID المستخدم. مرر ذلك المعرف مجددا في الطلبات اللاحقة و:

- ستصل الصفحات اللاحقة عبر نفس المخرج، مما يحافظ على اتساق ملفات تعريف الارتباط للجلسة وحدود المعدل لدى الخادم الهدف.
- يظل الجلب المحدد لدولة معينة ضمن قائمة السماح الخاصة بك دون الحاجة لاختيار جديد.
- تعيد نقطة نهاية `POST /api/single/` الاقتصادية التنفيذ عبر proxy دفعت مسبقا لاكتشافه، وبتكلفة Single بدلا من تكلفة Proxy.

معرف الـ proxy هو سلسلة base36 غير شفافة (مثل `A1B2C3`). وليس عنوان IP صريحا أبدا.

## أين يقع المعرف في الاستجابة

| Endpoint | Field | When it's present |
|----------|-------|-------------------|
| `POST /api/auto/` | `session.proxy` | عندما تكون قيمة `returnSession` هي `true` (القيمة الافتراضية) |
| `POST /api/single/` | `proxy` (المستوى الأعلى) | فقط عندما يقدم الطلب حقل `proxy` |
| `POST /api/proxy/` | `proxy` (المستوى الأعلى) | دائما، عند النجاح |
| `POST /api/browser/` | `proxy` (المستوى الأعلى) | فقط عندما يقدم الطلب حقل `proxy` |

للحصول على مخرج جديد دون تثبيت مخرج محدد، ابدأ بـ Auto أو Proxy. كلاهما يكتشف مخرجا صالحا ويعيد معرفه لك.

## النمط 1: Auto يكتشف، وSingle يعيد التنفيذ

الخيار الأفضل عندما يكون الهدف غير معروف لك بعد. يتدرج Auto في خطوات الفحص مرة واحدة، ثم يعيد Single استخدام الجلسة الناجحة لكل صفحة لاحقة.

```python
import requests

API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
}).json()

session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")

# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
    body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
    if proxy:
        body["proxy"] = proxy
    headers = []
    if user_agent:
        headers.append(["User-Agent", user_agent])
    if session.get("cookies"):
        headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
    if headers:
        body["headers"] = headers
    p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, p["status"])
```

اقرأ الـ session باستخدام `.get()`. تحتوي الـ session الناجحة عبر جلب proxy عادي على `proxy` بدون `userAgent`، وبعض الردود لا تحمل أي `session` على الإطلاق.

تكلفة استدعاء Auto مطابقة لما يستهلكه مسار الـ ladder الخاص به. تكلفة كل استدعاء Single لاحق هي 2 من الرصيد (Single مع `unblocker`، وهو الخيار الافتراضي).

## النمط 2: يكتشف Proxy، ويعرض Browser عبر نفس نقطة الخروج

استخدم هذا النمط عندما يتعين على الهدف رؤية بلد خروج محدد ويتطلب المحتوى النهائي تشغيل JavaScript.

```bash
# Step 1: pick a country-scoped exit with Proxy.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "exitCountries": ["FR", "GB"],
    "request": {"method": "GET", "url": "https://example.com/pricing"}
  }'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"

# Step 2: render the JS-heavy page through THAT exit.
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "proxy": "A1B2C3",
    "timeout_ms": 20000
  }'
```

لا تستدعِ `/api/proxy/` مجددًا لتحديث التحديد. قد يختار الاستدعاء الجديد منفذ خروج مختلفًا، ما يُلغي الغرض من التثبيت. إذا توقف منفذ الخروج المُثبّت عن العمل، شغّل استدعاء `/api/proxy/` جديدًا لاختيار منفذ آخر، ثم تابع باستخدامه.

## النمط 3: تخطي منفذ خروج محظور

إذا بدأ منفذ خروج كان يعمل سابقًا في إرجاع حالات رفض أو صفحات تحقق، فاطلب من FourA تجنبه في عملية الاختيار التالية.

```json
{
  "maxTries": 5,
  "ignoreProxies": ["A1B2C3"],
  "request": { "method": "GET", "url": "https://example.com/data" }
}
```

يقبل `ignoreProxies` قائمة بمعرفات proxy من استجابات سابقة. وهو يعمل على `/api/proxy/` و`/api/auto/`. يتم الالتزام بالقائمة في كل محاولة إعادة داخلية، لذا فإن استدعاءً واحدًا باستخدام `ignoreProxies` لن يختار أبدًا منافذ الخروج المحظورة.

## مدة بقاء الجلسة المثبتة نشطة

يبقى منفذ الخروج نفسه نشطًا طالما أن الـ proxy الأساسي يعمل بصورة سليمة، عادةً من دقائق إلى ساعات. إذا بدأت إعادة التشغيل في إرجاع تحديات أو عمليات حظر أو عمليات إعادة توجيه غير متوقعة، فمن المحتمل أنه تم تدوير منفذ الخروج أو قام الهدف بتحديث تصريح المرور الخاص به.

خياران عند حدوث ذلك:

1. استدعاء `/api/auto/` جديد لنفس الـ URL. سيكتشف وضع Auto جلسة عمل جديدة؛ تجاهل المعرفات السابقة.
2. استدعاء `/api/proxy/` جديد باستخدام `ignoreProxies: ["<burned-id>"]` إذا كنت تريد مواصلة التثبيت يدويًا.

تنتهي أيضًا صلاحية ملفات cookie الخاصة بالجلسة من استجابة Auto وفقًا للجدول الزمني الخاص بالهدف. تربط بعض المواقع التصريح لساعات؛ والبعض الآخر لدقائق. تعامل مع الجلسة كذاكرة تخزين مؤقت (cache)، وليس كرمز دائم.

## عندما يتعذر تثبيت معرف

يمكن إرجاع ثلاثة أخطاء 400 من قيمة `proxy`، ولكل منها معنى مختلف:

| الخطأ | ما حدث | ما يجب فعله |
|-------|---------------|------------|
| `Invalid proxy format` | القيمة ليست معرفًا أصدرته FourA. يتم تصنيف عنوان الـ proxy المباشر هنا. | أرسل السلسلة المبهمة من الاستجابة كما هي حرفيًا. |
| `Proxy not found` | تم فك تشفير المعرف، لكنه لم يعد يشير إلى منفذ خروج نشط. | خذ منفذ خروج جديدًا من استدعاء Auto أو Proxy جديد. |
| `Managed exit: this proxy id cannot be pinned to a request` | المعرف خاص بمنفذ خروج مميز، وقد تم استهلاك حركة المرور المميزة لخطتك لهذه الفترة، أو أن خطتك لا تتضمن منافذ خروج مميزة. | نفّذ الاستدعاء عبر `POST /api/proxy/` واستخدم أي منفذ خروج يختاره، أو أضف حركة مرور مميزة وثبته مرة أخرى. |

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

## أخطاء شائعة

- **إعادة استخدام معرف proxy عبر الحسابات.** لا تشارك المعرفات بين الحسابات: المعرف الذي يمكن لحساب تثبيته قد يُرفض لحساب آخر، على سبيل المثال مخرج premium على خطة لا تتضمن حركة مرور premium.
- **محاولة فك ترميز المعرف.** سلسلة base36 معتمة. لا تحللها، ولا تحذف منها أحرفًا، ولا تحولها إلى أحرف صغيرة. أعد تمريرها كما هي تمامًا.
- **التثبيت عبر مخرج يخضع لـ rate limit.** إذا كان الهدف يطبق rate limit لكل IP، فإن توجيه العديد من الـ requests عبر مخرج واحد سيؤدي إلى الحظر بشكل أسرع. لأحمال العمل ذات الحجم الكبير، اسمح لـ Auto أو Proxy بالتدوير عبر مخارج متعددة وقم بالتثبيت فقط عندما يتطلب الهدف ذلك فعليًا.
- **تثبيت مخرج premium عن غير قصد.** المعرف الناتج عن استدعاء خدمه مخرج premium (`exitClass: "premium"` على Proxy أو Auto) يثبت مخرج premium. المعرف الناتج عن استدعاء Auto من نوع premium يثبت مخرج premium على Single أو Browser، ولكن ليس بالضرورة نفس العنوان الذي استخدمه Auto. كل إعادة تشغيل من خلاله تُحسب ضمن حركة مرور premium الخاصة بك، ويحمل الـ response القيمة `X-FourA-Exit-Class: premium`.
- **إرسال `exitCountries` على خطة لا تتضمن الاستهداف الجغرافي.** تحديد نطاق الدولة مشمول بدءًا من خطة Startup فما فوق. على خطة لا تتضمن ذلك، يُرفض الاستدعاء الذي يرسل `exitCountries` مع `403` و`X-FourA-Limit: plan_limit_feature`.
- **تجاهل `exitCountries` في الاستدعاء اللاحق.** إذا قمت بتثبيت مخرج محدد النطاق ثم استدعيت Proxy مجددًا دون `exitCountries`، فقد يمر الاستدعاء اللاحق عبر دولة مختلفة. احتفظ بالنطاق في كل استدعاء يحتاج إليه.

## مواضيع ذات صلة

- [API Endpoints](https://foura.ai/docs/api/endpoints): مرجع المعلمات والـ response بالكامل
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): كيف يبني Auto الجلسة التي تعيد تشغيلها
- [Protected sites](https://foura.ai/docs/guides/protected-sites): متى يفيد التثبيت ومتى يكون التدوير أفضل
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): `no_eligible_proxy` وأخطاء proxy الأخرى
- [Why a Proxy Request Ran Out of Tries](https://foura.ai/docs/troubleshooting/proxy-attempt-report): قراءة `attemptReport` عند توقف استدعاء Proxy بعد استنفاد المحاولات
