دليل ربط الشركاء — البروكسيات

1نظرة عامة

بروكسيات 4G/5G بمدةٍ تختارها، تُسلَّم بياناتها فور الشراء.

البروكسي لا يُشترى كمنتجٍ عادي: الشريك يختار باقة ثم موقعاً (دولة ← مدينة ← مشغّل) ثم بروكسياً متاحاً ثم مدة ونوع الاتصال. لذلك له نداءاته الخاصة تحت /proxies، وهي تعمل بمفتاح الربط نفسه وبرصيد المحفظة نفسه وبسعر شريحتك.

كيف يجري الشراء

1. تجلب الباقات وتختار واحدة (pkg).
2. تضيّق الموقع: دول الباقة، ثم مدن الدولة، ثم مشغّلو المدينة — وكلها اختيارية.
3. تجلب البروكسيات المتاحة الآن بهذه الفلاتر وتختار واحداً (parent).
4. تجلب مدد الباقة وأسعارها بشريحتك وتختار مدة (duration).
5. تشتري بمرجعٍ فريد من طرفك — يُخصم الثمن وتعود بيانات الاتصال في الرد.

2الأساسيات والمفتاح

القواعد نفسها في الأدلة الثلاثة — مختصرةً هنا.

3البدء السريع

من صفر إلى بروكسي يعمل في أربعة نداءات.

# 1) Packages, at your tier price
curl -H "X-API-Key: axk_YOUR_KEY" https://axissstore.com/api/partner/v1/proxies/packages

# 2) Proxies available right now in a package
curl -H "X-API-Key: axk_YOUR_KEY" "https://axissstore.com/api/partner/v1/proxies/parents?pkg=1"

# 3) Durations and prices of the package
curl -H "X-API-Key: axk_YOUR_KEY" "https://axissstore.com/api/partner/v1/proxies/durations?pkg=1"

# 4) Buy — with your own unique reference
curl -X POST https://axissstore.com/api/partner/v1/proxies/orders \
  -H "X-API-Key: axk_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"pkg":1,"parent":3001,"protocol":"socks","duration":"7","reference":"PRX-10001"}'

4الباقات والمدد

الباقة تحدّد فئة البروكسي ومددها وأسعارها.

{
  "items": [
    { "id": 2, "key": "silver", "name": "Silver", "desc": "…",
      "from_usd": "0.26", "durations": 6, "shortest": "ساعتين", "longest": "30 يوماً" },
    { "id": 1, "key": "golden", "name": "Golden", "desc": "…",
      "from_usd": "0.52", "durations": 6, "shortest": "ساعتين", "longest": "30 يوماً" }
  ],
  "total": 2
}

تُعاد الباقات التي لها مدد بسعر فقط، بترتيب فئاتها (Silver ثم Golden ثم Turbo).

{
  "items": [
    { "key": "0.02", "label": "ساعتان", "days": 0, "hours": 2, "price_usd": "0.26" },
    { "key": "7",    "label": "7 أيام", "days": 7, "hours": 0, "price_usd": "4.12" }
  ],
  "total": 2
}

5الموقع: الدولة والمدينة والمشغّل

ثلاثة نداءات متتالية لتضييق الاختيار — كلها اختيارية.

{ "items": [ { "id": 1, "name": "UNITED STATES", "code": "US" } ], "total": 1 }

{ "items": [ { "id": 1, "name": "FLORIDA" } ], "total": 1 }

{ "items": [ { "id": 133, "name": "5G T-mobile" } ], "total": 1 }

قائمة فارغة تعني أنّ لا شيء متاحاً بهذا الاختيار الآن — ارجع خطوةً أو اطلب /proxies/parents بفلترٍ أوسع.

6البروكسيات المتاحة

ما يمكن شراؤه الآن في الباقة — ومنه تأخذ parent.

{
  "items": [
    { "id": 3001, "technology": "5G", "http_port": 11000, "socks_port": 11001, "rotation": 30,
      "country": "UNITED STATES", "city": "FLORIDA", "carrier": "5G T-mobile" }
  ],
  "total": 1
}

• حتى 30 بروكسياً في الرد. إن لم يوجد شيء بكل الفلاتر معاً تُعاد نتائج فلترٍ أوسع (المدينة، ثم الدولة، ثم الباقة) — فتحقّق من country/city/carrier في كل عنصر قبل عرضه.
• القائمة لحظية: بروكسي ظهر قبل دقائق قد يمتلئ. اجلبها قبل الشراء مباشرةً.

{ "username": "ax3f9a2b", "password": "c01d2e77a4" }

7شراء بروكسي

يُخصم الثمن من محفظتك ويُنشأ البروكسي فوراً — في نداء واحد.

curl -X POST https://axissstore.com/api/partner/v1/proxies/orders \
  -H "X-API-Key: axk_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{
    "pkg": 1, "parent": 3001,
    "protocol": "socks", "duration": "7",
    "username": "axuser1", "password": "secret99",
    "country": 1, "city": 1, "carrier": 133,
    "reference": "PRX-10001"
  }'

{
  "reference": "AX-PRX-3F9A2B01",
  "partner_reference": "PRX-10001",
  "kind": "purchase", "parent": "",
  "status": "completed", "active": true,
  "name": "بروكسي Golden — 7 أيام",
  "package": 1, "protocol": "socks", "duration": "7",
  "location": { "country": "UNITED STATES", "city": "FLORIDA", "carrier": "5G T-mobile" },
  "connection": {
    "host": "1.2.3.4", "port": "9000",
    "username": "axuser1", "password": "secret99",
    "protocol": "socks",
    "url": "socks5://axuser1:secret99@1.2.3.4:9000"
  },
  "expires_at": "2026-10-14T14:05",
  "total_usd": "4.12",
  "delivery": "الخادم: 1.2.3.4\nالمنفذ: 9000\n…",
  "created_at": "2026-10-07T14:05:31.825176",
  "completed_at": "2026-10-07T14:05:33.402118"
}

• الحالة الطبيعية completed في الرد نفسه ومعها connection — اعرضها لعميلك فوراً.
• إن رفض المصدر الإنشاء رفضاً مؤكَّداً (البروكسي امتلأ مثلاً) يعود الرد بـ201 والحالة refunded — المبلغ عاد لمحفظتك؛ اختر بروكسياً آخر بمرجعٍ جديد.
• إن كانت نتيجة المصدر غير محسومة (مهلة) يبقى الطلب processing للمراجعة: لا يُسترَد آلياً ولا يُعاد إنشاؤه. تابِعه بـGET، وتواصل مع الدعم إن طال.

8شكل ردّ البروكسي وحالاته

الشراء والمتابعة والتجديد والاستبدال تعيد الشكل نفسه.

الحالات — status

9بروكسياتي والمتابعة

لاسترجاع بيانات الاتصال في أي وقت.

curl -H "X-API-Key: axk_YOUR_KEY" https://axissstore.com/api/partner/v1/proxies/orders/PRX-10001

{ "items": [ { "reference": "AX-PRX-3F9A2B01", "active": true, "expires_at": "2026-10-14T14:05",
               "connection": { "host": "1.2.3.4", "port": "9000", ... }, ... } ], "total": 1 }

الطلب يظهر أيضاً في نداءات الطلبات العامة (GET https://axissstore.com/api/partner/v1/orders/{reference}) بنصّ التسليم في delivery — لكنّ نداءات /proxies هي التي تعيد connection وexpires_at حقولاً منفصلة.

10التجديد

تمديد بروكسي فعّال بأي مدةٍ من باقته — عمليةٌ مستقلة بثمنها ومرجعها.

{
  "expires_at": "2026-10-14T14:05",
  "package": 1,
  "protocol": "socks",
  "durations": [
    { "key": "0.02", "label": "ساعتان", "days": 0, "hours": 2, "price_usd": "0.26" },
    { "key": "7",    "label": "7 أيام", "days": 7, "hours": 0, "price_usd": "4.12" }
  ]
}

curl -X POST https://axissstore.com/api/partner/v1/proxies/orders/PRX-10001/renew \
  -H "X-API-Key: axk_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"duration":"7","reference":"PRX-10001-REN-1"}'

{ "reference": "AX-PRX-77C01D2E", "partner_reference": "PRX-10001-REN-1",
  "kind": "renew", "parent": "AX-PRX-3F9A2B01",
  "status": "completed", "active": false, "connection": null, ...,
  "total_usd": "4.12",
  "delivery": "جُدِّد البروكسي AX-PRX-3F9A2B01\nينتهي: 2026-10-21 14:05" }

• عند completed يتقدّم expires_at على البروكسي الأصلي — اقرأه من GET /proxies/orders/{البروكسي}. بيانات الاتصال لا تتغيّر.
• المدة الجديدة تُضاف إلى ما تبقّى: التجديد المبكر لا يضيّع شيئاً.
• إن رفض المصدر التجديد تصير العملية refunded ويعود ثمنها، والبروكسي الأصلي لا يتأثر.
• مدة ليست من مدد الباقة تعيد 422 بلا خصم.

11الاستبدال المجاني

نقل بروكسي فعّال إلى بروكسي آخر من الباقة نفسها — بلا ثمن، والمدة كما هي.

curl -X POST https://axissstore.com/api/partner/v1/proxies/orders/PRX-10001/swap \
  -H "X-API-Key: axk_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"parent":3007,"country":1,"city":4}'

{ "reference": "AX-PRX-3F9A2B01", "status": "completed", "active": true,
  "connection": { "host": "5.6.7.8", "port": "9100", "username": "axuser1", "password": "secret99",
                  "protocol": "socks", "url": "socks5://axuser1:secret99@5.6.7.8:9100" },
  "expires_at": "2026-10-14T14:05", ... }

• يتغيّر host وport؛ اسم المستخدم وكلمة المرور والنوع وexpires_at كما هي. حدِّث ما خزّنته لعميلك.
• لا يحمل reference ولا يخصم شيئاً. إن فشل (البروكسي الجديد ممتلئ، أو من باقة أخرى) يعود 422 وبروكسيك لا يتغيّر — اختر غيره.
• عند انقطاع الاتصال دون رد: اقرأ GET /proxies/orders/{reference} لتعرف هل نُفِّذ الاستبدال قبل أن تعيده.

12منع ازدواج العمليات

الشبكة تنقطع، والخصم يجب ألّا يتكرر.

• النداءان اللذان يخصمان مالاً — الشراء والتجديد — يحملان reference فريداً من طرفك. بدونه يُرفض النداء بـ422 قبل أي خصم.
• إعادة إرسال النداء نفسه بالمرجع نفسه تعيد العملية الأولى بحالتها الحالية (وبرمز 201 أيضاً) — لا بروكسي ثانٍ ولا خصم ثانٍ.
• عند انتهاء المهلة دون رد: أعد الإرسال بالمرجع نفسه، أو استعلم GET /proxies/orders/{reference}.
• المرجع واحدٌ لحسابك كله: مرجعٌ استُخدم لمنتج في المتجر أو لرقم أو لعمليةٍ أخرى لا يصلح هنا — يُرفض بـ409 conflict. استخدم بادئةً لكل نوع (PRX-، NUM-…) ولكل عملية مرجعاً جديداً.
• المرجع خاصّ بحسابك: شريكٌ آخر يستخدم المرجع نفسه لا يتعارض معك.

13الأخطاء

الصيغة نفسها في كل الواجهة — ابنِ منطقك على code لا على نص الرسالة.

HTTP/1.1 422 Unprocessable Entity
{
  "code": "validation_error",
  "message": "هذه المدة لم تعد متاحة — اختر مدةً أخرى.",
  "details": {}
}

14مثال كامل

أرخص مدة في أول باقة، على أول بروكسي متاح — ثم تجديده.

Python

import os, time, requests

API = "https://axissstore.com/api/partner/v1"
HEADERS = {"X-API-Key": os.environ["AXIS_API_KEY"]}   # key from an environment variable

def call(method, path, **kw):
    for attempt in range(5):
        try:
            r = requests.request(method, API + path, headers=HEADERS, timeout=30, **kw)
        except requests.RequestException:
            time.sleep(2 ** attempt); continue          # network error: retry with the same reference
        if r.status_code == 429:
            time.sleep(int(r.headers.get("Retry-After", "5"))); continue
        if r.status_code >= 500:
            time.sleep(2 ** attempt); continue
        data = r.json()
        if r.status_code >= 400:
            raise RuntimeError(f"{data['code']}: {data['message']}")
        return data
    raise RuntimeError("service unavailable")

def buy_proxy(shop_order_id, protocol="socks"):
    pkg = call("GET", "/proxies/packages")["items"][0]["id"]
    parents = call("GET", "/proxies/parents", params={"pkg": pkg})["items"]
    durations = call("GET", "/proxies/durations", params={"pkg": pkg})["items"]
    if not parents or not durations:
        raise RuntimeError("nothing available right now")
    proxy = call("POST", "/proxies/orders", json={
        "pkg": pkg, "parent": parents[0]["id"], "protocol": protocol,
        "duration": durations[0]["key"],
        "reference": f"PRX-{shop_order_id}"})              # fixed per purchase
    while proxy["status"] in ("paid", "processing"):
        time.sleep(15)
        proxy = call("GET", f"/proxies/orders/{proxy['reference']}")
    return proxy                                        # completed or refunded

p = buy_proxy(10001)
if p["status"] == "completed":
    print(p["connection"]["url"], p["expires_at"])
    # later: renew it for the first offered duration
    opts = call("GET", f"/proxies/orders/{p['reference']}/options")
    call("POST", f"/proxies/orders/{p['reference']}/renew", json={
        "duration": opts["durations"][0]["key"], "reference": "PRX-10001-REN-1"})

Node.js

const API = 'https://axissstore.com/api/partner/v1';
const headers = { 'X-API-Key': process.env.AXIS_API_KEY, 'Content-Type': 'application/json' };

async function axis(method, path, body) {
  const res = await fetch(API + path, { method, headers, body: body && JSON.stringify(body),
                                    signal: AbortSignal.timeout(30000) });
  const data = await res.json();
  if (!res.ok) throw new Error(`${data.code}: ${data.message}`);
  return data;
}

const pkg = (await axis('GET', '/proxies/packages')).items[0].id;
const parent = (await axis('GET', `/proxies/parents?pkg=${pkg}`)).items[0].id;
const duration = (await axis('GET', `/proxies/durations?pkg=${pkg}`)).items[0].key;

const proxy = await axis('POST', '/proxies/orders',
  { pkg, parent, protocol: 'http', duration, reference: 'PRX-10001' });
console.log(proxy.status, proxy.connection?.url, proxy.expires_at);

15أفضل الممارسات وقائمة التحقق

ما يميّز ربطاً يعمل لسنوات عن ربطٍ يتعطّل عند أول انقطاع.

قبل الإطلاق

16مرجع النداءات والدعم

كل نداءات قسم البروكسيات في جدول واحد.

• الدعم الفني: من صفحة «الدعم» في حسابك على https://axissstore.com — اذكر مرجع البروكسي (AX-PRX-… أو مرجعك) وتوقيت النداء.
• مفاتيحك: https://axissstore.com/api-access
• هذه الوثيقة على الإنترنت: https://axissstore.com/developers/proxies

سجل التغييرات

© 2026 AXIS GROUP — AXIS STORE. جميع الحقوق محفوظة.
هذه الوثيقة مرجعٌ تقني لشركاء AXIS STORE، وقد تُحدَّث — النسخة الأحدث دائماً على https://axissstore.com/developers/proxies.