مرجع FlashProxy API

تحقق من رصيدك وخططك، واقرأ استخدامك، وأنشئ بروكسيات وجدّد خططك من برامجك الخاصة. كل نقطة نهاية تُرجع JSON وتقرأ البيانات من حسابك فقط.

عنوان URL الأساسي: https://www.flashproxy.com

أنشئ مفتاح API في لوحة التحكم الخاصة بك على https://www.flashproxy.com/dashboard/api. المفتاح الكامل يظهر مرة واحدة فقط، لذا احفظه بأمان.

هل تستخدم وكيل ذكاء اصطناعي؟ أعطِه هذا المرجع كاملاً كملف Markdown واحد: https://www.flashproxy.com/api-reference.md. يتوفر مواصفة OpenAPI 3.1 على https://www.flashproxy.com/openapi.json.

البدء السريع

اعرض قائمة بخططك، ثم استخدم plan_id من الإجابة في نقاط النهاية الأخرى.

cURL

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Python

import requests

response = requests.get(
    "https://www.flashproxy.com/api/v1/plans?status=active&limit=10",
    headers={
        "Authorization": "Bearer fpk_live_YOUR_KEY",
    },
    timeout=30,
)
print(response.json())

Node.js

const response = await fetch("https://www.flashproxy.com/api/v1/plans?status=active&limit=10", {
  headers: {
    "Authorization": "Bearer fpk_live_YOUR_KEY",
  },
});
console.log(await response.json());

المصادقة

أرسل مفتاحك في رأس Authorization بصيغة Bearer fpk_live_…، أو في رأس X-API-Key.

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

صلاحيات المفتاح

الإذن	يسمح بـ
usage	قراءة البيانات المستخدمة والبيانات المتبقية وسرعة الاتصال الحالية. كل مفتاح يحتوي عليها.
proxies	إنشاء قوائم البروكسي. تحتوي الاستجابات على اسم المستخدم وكلمة المرور للبروكسي الخاص بك.
extend	تمديد الخطط. يتم دفع كل استدعاء من رصيد حسابك.

الحساب

المفتاح الحالي

GET /api/v1/key

يعيد المفتاح الذي تستدعي به: اسمه والبادئة والصلاحيات. مفيد عندما يجيب الاستدعاء 403 FORBIDDEN.

الصلاحية: usage

الطلب

curl "https://www.flashproxy.com/api/v1/key" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "key_id": "7d1c2b4e-…",
    "name": "Monitoring server",
    "key_prefix": "fpk_live_k3x9q2ma",
    "permissions": [
      "usage",
      "proxies",
      "extend"
    ],
    "created_at": "2026-09-29T12:00:00.000Z",
    "last_used_at": "2026-10-13T12:00:00.000Z"
  }
}

رصيد الحساب

GET /api/v1/balance

يعيد رصيدك الحالي المتاح، الذي تُدفع منه التوسيعات.

الصلاحية: usage

الطلب

curl "https://www.flashproxy.com/api/v1/balance" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "balance_usd": 42.18,
    "balance_cents": 4218,
    "currency": "USD"
  }
}

عرض الخطط

GET /api/v1/plans

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

الصلاحية: usage

المعاملات

الاسم	في	الوصف
status	query	all (الافتراضي)، active أو expired.
limit	query	عدد الخطط المراد إرجاعها، حتى 100. القيمة الافتراضية 50.
offset	query	عدد الخطط التي يتم تخطيها، للتصفح. القيمة الافتراضية 0.

الطلب

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "residential",
        "name": "Residential Proxies",
        "status": "active",
        "billed_by": "data",
        "created_at": "2026-09-13T12:00:00.000Z",
        "expires_at": "2027-03-12T12:00:00.000Z",
        "max_bytes": 10737418240,
        "bytes_used": 4294967296,
        "speed_mbps": null,
        "extend_with": "gb"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

قائمة المعاملات

GET /api/v1/transactions

يعيد دفعاتك والمحافظ والشراءات الرصيدية بأحدثها أولاً، للمحاسبة.

الصلاحية: usage

المعاملات

الاسم	في	مطلوب	الوصف
limit	query		عدد المعاملات المراد إرجاعها، حتى 100. القيمة الافتراضية 50.
offset	query		عدد المعاملات التي يتم تخطيها، للتصفح. القيمة الافتراضية 0.

الطلب

curl "https://www.flashproxy.com/api/v1/transactions?limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "FP-1791900000000-a1b2c3d4e",
        "type": "PURCHASE",
        "status": "COMPLETED",
        "amount_usd": 29.8,
        "payment_method": "BALANCE",
        "description": "Purchase of 1 item",
        "created_at": "2026-10-11T12:00:00.000Z",
        "completed_at": "2026-10-11T12:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0,
    "currency": "USD"
  }
}
```,## الاستخدام

### استخدام جميع الخطط النشطة

`GET /api/v1/usage`

يعيد سجل استخدام لكل خطة نشطة على حسابك.

الصلاحية: `usage`

**الطلب**

```bash
curl "https://www.flashproxy.com/api/v1/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "ipv6-datacenter",
        "name": "IPv6 Datacenter Proxies",
        "status": "active",
        "expires_at": "2026-11-01T12:00:00.000Z",
        "usage": {
          "bytes_used": 2639963,
          "max_bytes": null,
          "remaining_bytes": null,
          "percentage_used": null
        },
        "throughput_status": "ok",
        "throughput": {
          "source": "per_minute",
          "current_mbps": 412.5,
          "avg_mbps_5m": 380.1,
          "peak_mbps_1h": 955,
          "sampled_at": "2026-10-13T11:59:15.000Z",
          "data_delay_seconds": 45,
          "limit_mbps": 1000,
          "utilization_pct": 41.25
        },
        "generated_at": "2026-10-13T12:00:00.000Z"
      }
    ]
  }
}

استخدام خطة واحدة

GET /api/v1/plans/{plan_id}/usage

يعيد سجل استخدام إحدى خططك بغض النظر عن حالتها.

الصلاحية: usage

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.

الطلب

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "name": "IPv6 Datacenter Proxies",
    "status": "active",
    "expires_at": "2026-11-01T12:00:00.000Z",
    "usage": {
      "bytes_used": 2639963,
      "max_bytes": null,
      "remaining_bytes": null,
      "percentage_used": null
    },
    "throughput_status": "ok",
    "throughput": {
      "source": "per_minute",
      "current_mbps": 412.5,
      "avg_mbps_5m": 380.1,
      "peak_mbps_1h": 955,
      "sampled_at": "2026-10-13T11:59:15.000Z",
      "data_delay_seconds": 45,
      "limit_mbps": 1000,
      "utilization_pct": 41.25
    },
    "generated_at": "2026-10-13T12:00:00.000Z"
  }
}

سجل الاستخدام

GET /api/v1/plans/{plan_id}/usage/history

يعيد حركة المرور والسرعة على مدى الوقت في سلات ثابتة (دقيقة واحدة لساعة إلى 4 ساعات لـ 30 يوماً)، مع الإجماليات ومعدل النجاح والقمم. الطوابع الزمنية بتوقيت UTC. متاح لخطط ISP و ISP EU و Datacenter و IPv6 و Premium Unlimited.

الصلاحية: usage

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
range	query		نطاق زمني: 1h, 24h, 7d, 30d. القيمة الافتراضية 24h.

الطلب

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage/history?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "bucket_seconds": 900,
    "generated_at": "2026-10-13T12:00:00.000Z",
    "totals": {
      "bytes": 3221225472,
      "bytes_up": 214748364.8,
      "bytes_down": 3006477107.2,
      "connections": 48210,
      "success_pct": 99.2,
      "peak_mbps": 412.5,
      "peak_concurrent": 37
    },
    "series": [
      {
        "t": "2026-10-13T11:30:00.000Z",
        "bytes": 41943040,
        "bytes_up": 2097152,
        "bytes_down": 39845888,
        "mbps": 0.37,
        "connections_per_sec": 0.62,
        "concurrent": 12
      },
      {
        "t": "2026-10-13T11:45:00.000Z",
        "bytes": 52428800,
        "bytes_up": 3145728,
        "bytes_down": 49283072,
        "mbps": 0.47,
        "connections_per_sec": 0.71,
        "concurrent": 15
      }
    ]
  }
}

الوجهات الأعلى

GET /api/v1/plans/{plan_id}/destinations

يعيد المواقع التي اتصلت بها الخطة أكثر على مدى فترة زمنية، مع حركة المرور والاتصالات ومعدل النجاح لكل مضيف (أعلى 100).

الصلاحية: usage

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
range	query		نطاق زمني: 1h, 24h, 7d, 30d. القيمة الافتراضية 24h.

الطلب

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/destinations?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "destinations": [
      {
        "host": "example.com",
        "bytes_down": 1288490188.8,
        "bytes_up": 107374182.4,
        "connections": 18240,
        "failed": 96,
        "success_pct": 99.5
      }
    ]
  }
}

تقسيم الأخطاء

GET /api/v1/plans/{plan_id}/errors

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

الصلاحية: usage

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
range	query		نطاق زمني: 1h, 24h, 7d, 30d. القيمة الافتراضية 24h.

الطلب

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/errors?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "errors": [
      {
        "category": "timeout",
        "label": "Connection timed out",
        "hint": "The destination did not answer in time. Usually a slow or overloaded target site; retry with a longer client timeout, and check whether one destination dominates.",
        "count": 214
      }
    ]
  }
}
```,## البروكسيات

### مواقع الخطة

`GET /api/v1/plans/{plan_id}/locations`

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

الصلاحية: `usage`

**المعاملات**

| الاسم | في | مطلوب | الوصف |
| --- | --- | --- | --- |
| `plan_id` | path | مطلوب | معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans. |

**الطلب**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/locations" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "any_country": false,
    "countries": [
      {
        "code": "CA",
        "name": "Canada"
      },
      {
        "code": "FR",
        "name": "France"
      },
      {
        "code": "US",
        "name": "United States"
      }
    ]
  }
}

إنشاء بروكسيات

POST /api/v1/plans/{plan_id}/proxies

ينشئ أسطر بروكسي جاهزة للاستخدام لإحدى خططك النشطة، بنفس الطريقة التي يستخدمها منشئ لوحة التحكم.

الصلاحية: proxies

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
count	body		عدد الأسطر المراد إرجاعها، من 1 إلى 1000. القيمة الافتراضية 10.
country	body		رمز البلد المكون من حرفين، على سبيل المثال US. اتركه فارغًا للاختيار من أي بلد.
session	body		rotating لعنوان IP جديد مع كل طلب (الافتراضي)، أو sticky للحفاظ على نفس عنوان IP.
sticky_minutes	body		المدة المراد الاحتفاظ فيها بعنوان IP لاصق، من 1 إلى 1000 دقيقة. البروكسيات السكنية والجوال تقتصرها على 120. القيمة الافتراضية 30.
protocol	body		http (الافتراضي) أو socks5.
format	body		hostport لـ host:port:user:pass (الافتراضي)، أو url لـ scheme://user:pass@host:port.

الطلب

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/proxies" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"country":"US","session":"sticky","sticky_minutes":30,"protocol":"http","format":"hostport"}'

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "count": 2,
    "protocol": "http",
    "format": "hostport",
    "proxies": [
      "adam.flashproxy.io:8080:USERNAME-country-US-session-k3x9q2ma-time-30:PASSWORD",
      "adam.flashproxy.io:8080:USERNAME-country-US-session-p7d1v8tc-time-30:PASSWORD"
    ]
  }
}

قائمة IP الثابتة

GET /api/v1/plans/{plan_id}/ips

تُرجع عناوين IP الثابتة للخطة مع بيانات دخولها: عناوين IP الخروج المباشرة لخطط Datacenter، أو عناوين IP المؤجرة لخطط Dedicated ISP. تستخدم خطط البوابة الدوارة Generate proxies بدلاً من ذلك.

الصلاحية: proxies

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
protocol	query		http (الافتراضي) أو socks5. خطط Dedicated ISP v2 تدعم http فقط.
format	query		hostport لـ host:port:user:pass (الافتراضي)، أو url لـ scheme://user:pass@host:port.
limit	query		عدد عناوين IP المراد إرجاعها، حتى 10000. القيمة الافتراضية 1000. يعرض total العدد الكامل دائمًا.

الطلب

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/ips?protocol=http&limit=2" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "datacenter",
    "source": "live",
    "protocol": "http",
    "format": "hostport",
    "total": 2048,
    "count": 2,
    "proxies": [
      "203.0.113.10:777:USERNAME:PASSWORD",
      "203.0.113.11:777:USERNAME:PASSWORD"
    ]
  }
}
```,## التمديدات

### الحصول على عرض سعر لإضافة إضافية

`GET /api/v1/plans/{plan_id}/extend/quote`

تُرجع تكلفة الإضافة، مع تشغيل نفس الفحوصات كـ Extend a plan، دون شراء أي شيء.

الصلاحية: `usage`

**المعاملات**

| الاسم | في | مطلوب | الوصف |
| --- | --- | --- | --- |
| `plan_id` | path | مطلوب | معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans. |
| `gb` | query |  | GB للحصول على عرض سعر، للخطط المحاسبة حسب البيانات. |
| `days` | query |  | أيام للحصول على عرض سعر، للخطط المحاسبة حسب الوقت. أرسل gb أو days وليس كليهما. |

**الطلب**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend/quote?gb=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "added": {
      "gb": 10
    },
    "price_usd": 35,
    "currency": "USD"
  }
}

إضافة إضافية للخطة

POST /api/v1/plans/{plan_id}/extend

تضيف بيانات (GB) أو وقتًا (أيام) إلى إحدى خططك وتدفع من رصيد حسابك، بنفس السعر المعروض في لوحة التحكم.

الصلاحية: extend

المعاملات

الاسم	في	مطلوب	الوصف
plan_id	path	مطلوب	معرّف الخطة، كما يتم إرجاعه في plan_id بواسطة List plans.
Idempotency-Key	header	مطلوب	سلسلة نصية فريدة لهذه الإضافة. راجع قسم Idempotency أدناه.
gb	body		GB المراد إضافتها، للخطط المحاسبة حسب البيانات. رقم صحيح من 1 إلى 2,000,000.
days	body		أيام للإضافة، للخطط المحاسبة حسب الوقت: من 1 إلى 365، أو 1, 7, 30, 60 لـ Premium Unlimited Residential. أرسل gb أو days وليس كليهما.

الطلب

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Idempotency-Key: extend-2026-10-13-001" \
  -H "Content-Type: application/json" \
  -d '{"gb":10}'

الاستجابة · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "charged_usd": 35,
    "added": {
      "gb": 10
    },
    "plan": {
      "status": "active",
      "expires_at": "2027-04-11T12:00:00.000Z",
      "max_bytes": 21474836480
    },
    "replayed": false
  }
}
```,## المنتجات والأسعار

### المنتجات والأسعار

`GET /api/v1/products`

تُرجع كل منتج مع مستويات سعره لكل GB (يتم فرض الفاتورة على كامل المبلغ بسعر المستوى الذي يقع فيه) وأسعاره حسب السرعة والأيام. استخدم Quote an extension للحصول على السعر الدقيق لخطة محددة.

الصلاحية: `usage`

**الطلب**

```bash
curl "https://www.flashproxy.com/api/v1/products" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

الاستجابة · 200

{
  "success": true,
  "data": {
    "products": [
      {
        "product": "datacenter",
        "name": "Datacenter Proxies",
        "billed_by": [
          "data",
          "time"
        ],
        "data_pricing": [
          {
            "up_to_gb": 1,
            "per_gb_usd": 0.7
          },
          {
            "up_to_gb": 5,
            "per_gb_usd": 0.65
          }
        ],
        "time_pricing": [
          {
            "mbps": 10,
            "days": 1,
            "price_usd": 1
          },
          {
            "mbps": 10,
            "days": 30,
            "price_usd": 18
          }
        ]
      }
    ],
    "currency": "USD"
  }
}

التكرار الآمن

توسيع الخطة ينفق رصيدك، لذا كل استدعاء توسيع يحتاج رأس Idempotency-Key.

استخدم مفتاحًا جديدًا لكل ملحق تريد شراءه: من 8 إلى 128 حرفًا أو رقمًا أو - أو _.
إذا انتهت مهلة انتظار الاستدعاء أو أرجع خطأ 5xx، أرسله مجددًا بنفس المفتاح. سيتم فرض رسوم عليك مرة واحدة على الأكثر، وستعود الملحقات المكتملة مع replayed: true.
استخدام المفتاح نفسه مع خطة أو مبلغ مختلف يُرجع 409 IDEMPOTENCY_KEY_REUSED.
أثناء تنفيذ الاستدعاء الأول، يعيد الاستدعاء الثاني بنفس المفتاح 409 REQUEST_IN_PROGRESS.

حقول الاستجابة

كل خطة في استجابة الاستخدام تحمل نفس السجل.

الحقل	المعنى
usage.*	bytes_used، max_bytes، remaining_bytes و percentage_used. يكون max_bytes و remaining_bytes قيمة null في الخطط بدون حد أقصى للبيانات. يكون bytes_used قيمة null في Unlimited Residential، والتي يتم محاسبتها حسب الوقت والسرعة.
throughput.current_mbps	قياس السرعة الأخير: الدقيقة الكاملة الأخيرة لمعظم المنتجات، 0 عند عدم وجود حركة مرور حديثة.
throughput.avg_mbps_5m / peak_mbps_1h	متوسط 5 دقائق وذروة السرعة لمدة ساعة واحدة.
throughput.limit_mbps	حد السرعة في خطتك. utilization_pct هي السرعة الحالية مقسومة على هذا الحد.
throughput.sampled_at	متى تم أخذ آخر قياس. data_delay_seconds يخبرك بعمره.

قيم throughput_status

القيمة	المعنى
ok	معلومات الإنتاجية متاحة.
pending	جاري جمع السرعة. بالنسبة لـ Unlimited Residential قد تستغرق القراءة الأولى حتى 10 دقائق؛ استمر في الاستطلاع كالمعتاد.
unavailable	السرعة غير متاحة مؤقتاً. أعد المحاولة لاحقاً.
not_supported	هذا المنتج لا يحتوي على مقاييس السرعة حتى الآن. عدادات الاستخدام تعمل بشكل طبيعي.

الحدود

60 طلب في الدقيقة لكل مفتاح
جميع مفاتيح حساب واحد تشارك حداً أقصى قدره 120 طلب في الدقيقة.
عند تجاوز الحد تحصل على 429 مع رأس Retry-After: 60.
استدعاءات التمديد تُحسب أيضاً ضمن حد 6 عملية شراء رصيد في الدقيقة لكل حساب، مشترك مع لوحة التحكم.
يتم قياس السرعة في الدقيقة، لذا الاستطلاع كل 15 إلى 30 ثانية كافٍ تماماً.
يمكن أن تكون إجابات الاستخدام قديمة بحد أقصى 15 ثانية وأسعار المنتجات قديمة بحد أقصى 5 دقيقة.

الأخطاء

الأخطاء لها شكل واحد: success يكون false و error يحمل رمزاً ورسالة قابلة للقراءة.

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

الحالة	الكود	المعنى
400	INVALID_REQUEST	الجسم أو أحد المعاملات غير صحيح. الرسالة تحدد أيها.
400	IDEMPOTENCY_KEY_REQUIRED	استدعاء تمديد بدون رأس Idempotency-Key صحيح.
400	PAYMENT_REFUSED	تم رفض عملية الدفع من الرصيد. تواصل مع الدعم.
401	UNAUTHORIZED	مفتاح مفقود أو غير صحيح أو ملغى.
402	INSUFFICIENT_BALANCE	رصيدك منخفض جداً لهذا التمديد. أعد التعبئة وحاول مجدداً.
403	FORBIDDEN	المفتاح ليس لديه الإذن الذي تحتاجه هذه النقطة النهائية.
404	NOT_FOUND	لا توجد خطة كهذه في حسابك.
409	PLAN_NOT_ACTIVE	يمكن توليد البروكسيات فقط من خطة نشطة.
409	PLAN_NOT_READY	الخطة ليس لديها بيانات اعتماد البروكسي بعد. حاول مجدداً قريباً.
409	IDEMPOTENCY_KEY_REUSED	تم استخدام هذا Idempotency-Key بالفعل لتمديد مختلف.
409	REQUEST_IN_PROGRESS	التمديد بهذا Idempotency-Key قيد التنفيذ. أعد المحاولة في لحظة.
409	PRICE_MISMATCH	تغير السعر أثناء المعالجة. أعد المحاولة بـ Idempotency-Key جديد.
422	EXTENSION_NOT_SUPPORTED	لا يمكن تمديد هذه الخطة عبر API. مددها من لوحة التحكم.
422	PROXIES_NOT_SUPPORTED	الخطط المخصصة لديها قائمة IP ثابتة. حملها من لوحة التحكم.
422	USAGE_HISTORY_NOT_SUPPORTED	هذا المنتج ليس لديه سجل الاستخدام. استخدم نقاط الاستخدام لعدادات البيانات.
422	IPS_NOT_SUPPORTED	هذه الخطة تستخدم بوابة دوارة وليس قائمة IP ثابتة. استخدم توليد البروكسيات.
422	CUSTOM_PLAN_EXTEND_VIA_SUPPORT	تمديد الخطط المخصصة يتم بواسطة الدعم فقط.
429	RATE_LIMITED	عدد الطلبات كثير جداً. انتظر Retry-After ثم أعد المحاولة.
500	INTERNAL_ERROR	خطأ مؤقت. حاول مجدداً.
502	EXTENSION_FAILED	لم يتم إكمال التمديد. أعد المحاولة بنفس Idempotency-Key فقط إذا ذكرت الرسالة أنه لم يتم خصم أي مبلغ؛ وإلا فتواصل مع الدعم.
503	IPS_UNAVAILABLE	لم يتمكن من تحميل قائمة IP الآن. أعد المحاولة في دقيقة.