انتقل إلى المحتوى
hiproxy
ابدأ الآن

دليل HiProxy API

ما تفعله في لوحة التحكم يمكنك فعله أيضًا من الكود الخاص بك. اقرأ رصيدك وبيانات الاتصال، وافحص الأسعار، واطلب من رصيدك، وابنِ أسماء مستخدمي البروكسي مع الخيارات، وكل ذلك عبر REST API.

احصل على مفتاح APIعرض نقاط الاتصال

كيف أبدأ؟

  1. 1سجّل باسم مستخدم وادخل إلى لوحة التحكم.
  2. 2أصدر مفتاح API في تبويب الاتصال. يظهر المفتاح الكامل مرة واحدة فقط، لذا احفظه في مكان آمن فورًا.
  3. 3ضع المفتاح في ترويسة Authorization في كل طلب يحتاج إليه.
  4. 4استدعِ /account أولًا للتأكد من أن المفتاح يعمل، ثم اطلب باستخدام /orders.

كيف تعمل المصادقة؟

الطلبات الخاصة بحسابك (account وorders وproxy-user) تحتاج إلى مفتاح API. أرسله في الترويسة بصيغة Authorization: Bearer hpk_... الأسعار والدول وعروض الأسعار متاحة للجميع ولا تحتاج إلى مفتاح.

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

HTTP header
Authorization: Bearer hpk_your_api_key

عنوان URL الأساسي وصيغة البيانات

عنوان URL الأساسي
https://hiproxy.shop/api/v1
محتوى الطلب والاستجابة
application/json
المبالغ
USD كرقم، مثل 1036.60
الطوابع الزمنية
ISO 8601 (UTC)

هل توجد حدود لمعدل الطلبات؟

يمكن لكل مفتاح API إجراء حتى 60 استدعاء في الدقيقة. نقاط الاتصال العامة التي تُستدعى دون مفتاح تسمح بـ 60 استدعاء في الدقيقة لكل IP. إذا تجاوزت الحد تحصل على HTTP 429. انتظر دقيقة ثم أرسل مجددًا.

كيف تبدو استجابة الخطأ؟

تحصل على رمز حالة HTTP مع جسم JSON يحتوي على رمز خطأ قصير ورسالة.

مثال
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}
code
bad_requestHTTP 400قيمة مطلوبة مفقودة، أو أن هذا المنتج لا يقبل هذه القيمة.
unauthorizedHTTP 401لم يُرسل مفتاح API، أو أن المفتاح خاطئ.
insufficient_balanceHTTP 402رصيدك أقل من إجمالي الطلب. لم يُمس رصيدك.
not_foundHTTP 404لا يوجد في حسابك طلب بهذا المعرّف.
rate_limitedHTTP 429تجاوزت حد الطلبات في الدقيقة.
server_errorHTTP 500لم يتمكن الخادم من إكمال الطلب. لم يُمس رصيدك.

نقاط الاتصال

قراءة حسابك

GET/api/v1/accountيحتاج إلى مفتاح API

يعرض رصيدك ومضيف البروكسي ومنافذه واسم مستخدم البروكسي وكلمة المرور وقائمة عناوين IP المسموح بها.

الطلب
curl https://hiproxy.shop/api/v1/account \
  -H "Authorization: Bearer hpk_your_api_key"
الاستجابة
{
  "username": "hi_user01",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.hiproxy.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "hpexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

قراءة المنتجات والأسعار

GET/api/v1/productsدون مفتاح

يعرض حدود الطلب لكل منتج والسعر لكل فئة وخصومات المدة. يستخدم جدول الأسعار نفسه الموجود في صفحة الأسعار.

الطلب
curl https://hiproxy.shop/api/v1/products
الاستجابة
{
  "currency": "USD",
  "prices_as_of": "2026-10-31",
  "products": [
    {
      "id": "unlimited",
      "unit": "day",
      "quantity": {
        "meaning": "days",
        "min": 1,
        "max": 365
      },
      "...": "..."
    },
    {
      "id": "residential",
      "unit": "gb",
      "...": "..."
    }
  ]
}

قائمة الدول والمدن

GET/api/v1/countriesدون مفتاح

يعرض الدول التي يدعمها كل منتج وقيم المدن التي تُستخدم في خيار -city- في اسم المستخدم.

الحقلالمعنى
productاختياريواحد من unlimited وresidential وisp وdatacenter. القيمة الفارغة تعني residential.
الطلب
curl "https://hiproxy.shop/api/v1/countries?product=datacenter"
الاستجابة
{
  "product": "datacenter",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "region": "americas",
      "datacenter": true,
      "cities": [
        {
          "name": "New York",
          "value": "new_york"
        },
        {
          "name": "Los Angeles",
          "value": "los_angeles"
        }
      ]
    }
  ]
}

الحصول على عرض سعر

POST/api/v1/quoteدون مفتاح

يحسب إجمالي الطلب دون المساس برصيدك. أرسل المحتوى نفسه الذي سترسله لتنفيذ الطلب.

الحقلالمعنى
productمطلوبإحدى القيم unlimited أو residential أو isp أو datacenter.
quantityمطلوبعدد الأيام لـ unlimited (1~365)، وعدد GB لـ residential (5~5,000)، وعدد عناوين IP لـ isp (1~1,000) أو datacenter (5~5,000).
concurrencyاختياريلـ unlimited فقط. اختر 200 أو 500 أو 1000 أو 2000.
bandwidthاختياريلـ unlimited فقط، بوحدة Mbps. اختر 100 أو 200 أو 500 أو 1000.
monthsاختياريلـ isp وdatacenter فقط. اختر 1 أو 3 أو 6 أو 12.
countryاختياريلـ isp وdatacenter فقط. رمز دولة من حرفين مثل jp. القيم الصالحة مدرجة في /countries.
الطلب
curl -X POST https://hiproxy.shop/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
الاستجابة
{
  "product": "unlimited",
  "quantity": 30,
  "unit_price_usd": 8.78,
  "unit": "day",
  "total_usd": 263.4
}

تنفيذ طلب

POST/api/v1/ordersيحتاج إلى مفتاح API

يخصم الإجمالي من رصيدك وينشئ الطلب. يبدأ بحالة pending (قيد التفعيل) ويتحول إلى active عندما يجهز. الطلب الذي يتعذّر تفعيله يصبح refunded، ويعود كل ما دفعته إلى رصيدك. إذا كان رصيدك غير كافٍ تحصل على 402.

الحقلالمعنى
productمطلوبإحدى القيم unlimited أو residential أو isp أو datacenter.
quantityمطلوبعدد الأيام لـ unlimited (1~365)، وعدد GB لـ residential (5~5,000)، وعدد عناوين IP لـ isp (1~1,000) أو datacenter (5~5,000).
concurrencyاختياريلـ unlimited فقط. اختر 200 أو 500 أو 1000 أو 2000.
bandwidthاختياريلـ unlimited فقط، بوحدة Mbps. اختر 100 أو 200 أو 500 أو 1000.
monthsاختياريلـ isp وdatacenter فقط. اختر 1 أو 3 أو 6 أو 12.
countryاختياريلـ isp وdatacenter فقط. رمز دولة من حرفين مثل jp. القيم الصالحة مدرجة في /countries.
الطلب
curl -X POST https://hiproxy.shop/api/v1/orders \
  -H "Authorization: Bearer hpk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
الاستجابة
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1036.6
}

قائمة الطلبات

GET/api/v1/ordersيحتاج إلى مفتاح API

يعرض حتى 100 من طلباتك، الأحدث أولًا.

الحقلالمعنى
statusاختياريواحد من pending وactive وrefunded. القيمة الفارغة تعرض الطلبات بأي حالة.
الطلب
curl "https://hiproxy.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer hpk_your_api_key"
الاستجابة
{
  "orders": [
    {
      "id": "HP-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.78,
      "total_usd": 263.4,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

قراءة طلب واحد

GET/api/v1/orders/{id}يحتاج إلى مفتاح API

يعرض طلبًا واحدًا حسب معرّفه. مفيد للتحقق من انتهاء التفعيل.

الحقلالمعنى
idمطلوبمعرّف الطلب، مثل HP-7KQ2M-X4HTD.
الطلب
curl https://hiproxy.shop/api/v1/orders/HP-7KQ2M-X4HTD \
  -H "Authorization: Bearer hpk_your_api_key"
الاستجابة
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "active",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:40:02.511Z"
  }
}

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

GET/api/v1/proxy-userيحتاج إلى مفتاح API

يعطيك اسم مستخدم بروكسي يتضمن خياراتك، مع روابط HTTP وSOCKS5 يمكنك لصقها مباشرة. دون session يتغير IP مع كل طلب.

الحقلالمعنى
productاختياريواحد من unlimited وresidential وisp وdatacenter. القيمة الفارغة تعني unlimited.
countryاختياريرمز دولة من حرفين مثل jp.
cityاختياريقيمة مدينة من /countries مثل tokyo. تعمل فقط مع country.
sessionاختياريمن 1 إلى 32 حرفًا أو رقمًا. الطلبات التي تحمل session نفسها تستخدم IP نفسه.
ttlاختياريعدد دقائق الاحتفاظ بـ IP الجلسة، من 1 إلى 60. القيمة الفارغة تعني 30.
الطلب
curl "https://hiproxy.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer hpk_your_api_key"
الاستجابة
{
  "username": "hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6100",
  "socks5": "socks5h://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6200"
}

مثال خطوة بخطوة

سكربت واحد يفحص السعر، ويطلب من رصيدك، ويتصل عبر IP ياباني.

Python (requests)
import requests

API = "https://hiproxy.shop/api/v1"
HEAD = {"Authorization": "Bearer hpk_your_api_key"}

# 1) Check the price first
plan = {"product": "residential", "quantity": 100}
print(requests.post(f"{API}/quote", json=plan).json())

# 2) Order from your balance
r = requests.post(f"{API}/orders", json=plan, headers=HEAD)
order = r.json()["order"]
print(order["id"], order["status"])

# 3) Get a username for Japanese IPs
u = requests.get(f"{API}/proxy-user", headers=HEAD,
                 params={"product": "residential", "country": "jp"}).json()
proxies = {"http": u["http"], "https": u["http"]}
print(requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30).json())
Node.js 18+
const API = "https://hiproxy.shop/api/v1";
const HEAD = { Authorization: "Bearer hpk_your_api_key", "Content-Type": "application/json" };

// Check the balance
const acc = await fetch(`${API}/account`, { headers: HEAD }).then((r) => r.json());
console.log(acc.balance_usd);

// Order 7 days of unlimited
const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ product: "unlimited", quantity: 7, concurrency: 500, bandwidth: 100 }),
});
if (res.status === 402) console.log("Top up first");
else console.log((await res.json()).order.id);

الطلبات المقدمة عبر API تُعالج تمامًا مثل طلبات لوحة التحكم وتظهر في تبويب السجل. استبدل hpk_your_api_key في الأمثلة بمفتاح API الخاص بك.

استدعِ HiProxy من الكود الخاص بك

أنشئ حسابًا باسم مستخدم، وأصدر مفتاح API في لوحة التحكم، وستكون جاهزًا.

إنشاء حسابدليل الإعداد