المصادقة
يتم التوثيق عبر البريد الإلكتروني للحساب — لا حاجة لمفتاح منفصل. أرسل البريد الإلكتروني لاشتراك نشط مع كل طلب.
email يجب أن ينتمي إلى خطة نشطة. ليس لديك حساب بعد؟
Get proxies →
البداية السريعة
اطلب 50 خادم وكيل SOCKS5 مميز من الولايات المتحدة أو فرنسا، بصيغة JSON.
curl "https://www.proxydocker.com/proxylist/api?email=you@example.com&format=json\
&country=us,fr&type=socks5&anonymity=elite&limit=50"
import requests
resp = requests.get(
"https://www.proxydocker.com/proxylist/api",
params={
"email": "you@example.com",
"format": "json",
"country": "us,fr",
"type": "socks5",
"anonymity": "elite",
"limit": 50,
},
timeout=30,
)
proxies = resp.json()["Proxies"]
for p in proxies:
print(f"{p['ip']}:{p['port']}", p["type"], p["country"])
المعلمات (Parameters)
جميع المعلمات اختيارية باستثناء البريد الإلكتروني، ويمكن دمجها بحرية.
| المعيار | القيم | وصف |
|---|---|---|
emailمطلوب | البريد الإلكتروني للحساب | يجب أن ينتمي إلى اشتراك نشط. |
format | text · json | صيغة المخرجات. الافتراضي هو النص. |
country | us,fr | التصفية حسب الدولة (مفصولة بفاصلة). |
city | اسم المدينة | التصفية حسب المدينة. |
type | http · https · socks4 · socks5 | البروتوكول (مفصولة بفاصلة). |
port | رقم المنفذ | التصفية حسب المنفذ. |
anonymity | transparent · anonymous · elite | مستوى الخصوصية. |
state | المنطقة / الولاية | التصفية حسب المنطقة. |
timeout | مللي ثانية | فقط الـ Proxies التي تجيب خلال هذا الوقت أو أقل. |
limit | 1 – 10000 | عدد الوكلاء المراد إرجاعهم. القيمة الافتراضية هي 10000. |
إجابة
مع format=json تتلقى مصفوفة خوادم بروكسي. مع format=text تحصل على ip:port واحد في كل سطر.
{
"Proxies": [
{
"ip": "188.34.22.10",
"port": 1080,
"type": "SOCKS5",
"country": "United States",
"code": "US",
"city": "Ashburn",
"anonymity": "elite",
"timeout": 420
}
]
}
يتم إرجاع الوكلاء المفحوصة خلال آخر 7 أيام فقط، والأحدث أولاً.
الأخطاء
في حال وجود بريد إلكتروني مفقود/غير صالح أو خطة منتهية الصلاحية، يتم إرجاع HTTP 200 مع ملاحظة وقائمة فارغة:
{ "Notice": "Your package is already expired.", "Proxies": [] }
- ما يصل إلى 10,000 طلب يوميًا لكل حساب.
- البيانات نفسها متاحة في
/proxylist/downloadو/proxylist/v2/api.