API
JSON عبر HTTPS. أرسل مفتاح API في ترويسة Authorization. حتى 300 طلب في الدقيقة.
العنوان الأساسي
https://wingproxy.com/api/v1
المصادقة
الترويسة Authorization: Bearer YOUR_API_KEY. أنشئ المفتاح في صفحة مفتاح API بعد أول عملية شحن.
curl https://wingproxy.com/api/v1/account \ -H "Authorization: Bearer YOUR_API_KEY"
GET /account
الرصيد وحركة البيانات.
مثال على الاستجابة
{
"balance": "42.50",
"traffic_left_gb": "8.73",
"traffic_used_gb": "1.27"
}GET /prices
السعر لكل GB لكل حجم باقة.
مثال على الاستجابة
[
{ "from_gb": 1, "per_gb": "4.00" },
{ "from_gb": 10, "per_gb": "3.50" }
]POST /traffic {"gb": 10}
يشتري حركة بيانات من رصيدك.
مثال على الاستجابة
{
"id": 311,
"gb": 10,
"price": "35.00",
"status": "added"
}GET /list?country=de&session=sticky&minutes=10&count=5&format=hostport
ينشئ أسطر البروكسي. country: رمز دولة أو فارغ لأي دولة. session: rotating (افتراضي) أو sticky. minutes: من 1 إلى 120 (افتراضي 10، لـ sticky فقط). count: من 1 إلى 1000 (افتراضي 10). format: hostport (host:port:user:pass، افتراضي) أو url (user:pass@host:port). protocol: http (افتراضي) أو socks5.
مثال على الاستجابة
{
"lines": [ "gate.example:8000:user-country-de-session-a1b2-time-10:pass" ]
}GET /usage
حركة البيانات اليومية لآخر 30 يومًا.
مثال على الاستجابة
[
{ "day": "2026-10-13", "gb": "0.84" }
]الأخطاء
تُرجع الأخطاء حالة غير 2xx ومحتوى JSON يتضمن رمز الخطأ.
| unauthorized | مفتاح API مفقود أو غير صحيح |
| not_allowed | تُتاح واجهة API بعد أول عملية شحن |
| bad_request | حقل مفقود أو غير صحيح |
| not_enough_balance | اشحن الرصيد أولًا |
| not_added | تعذّرت إضافة حركة البيانات؛ أُعيد المبلغ إلى رصيدك |
| checking | لم يؤكد المزوّد؛ سنتحقق ثم نضيف حركة البيانات أو نعيد المبلغ |
| no_login | اشترِ حركة بيانات أولًا؛ يتم إنشاء بيانات دخول البروكسي حينها |
| rate_limited | طلبات كثيرة جدًا خلال دقيقة |