الحزم

قم بإدراج وفحص حزم الوكيل النشطة الخاصة بك عبر RaxyProxy REST API.

GET /packages

يُرجع جميع حزم الوكيل النشطة والمعلقة.

GET/api/v1/packages

packages-list.json

{
  "data": [
    {
      "id":           12,
      "name":         "Residential 10 GB",
      "type":         "residential",
      "status":       "active",
      "pool_type":    "residential",
      "quota_gb":     10.0,
      "used_gb":      3.2140,
      "available_gb": 6.7860,
      "usage_pct":    32.14,
      "blocked":      false,
      "synced_at":    "2026-05-29T11:00:00+00:00",
      "created_at":   "2026-04-01T11:59:00+00:00",
      "activated_at": "2026-04-01T12:00:00+00:00",
      "proxy": {
        "host":              "proxy.raxyproxy.com",
        "http_port":         823,
        "socks5_port":       824,
        "login":             "abc123def456",
        "threads":           100,
        "sticky_port_start": 10000,
        "sticky_port_end":   20000,
        "sticky_range":      { "start": 10000, "end": 20000 }
      }
    }
  ],
  "meta": { "version": "v1" }
}

GET /packages/:id

يُرجع حزمة واحدة. عند التوفير، تتضمن الاستجابة كتلة إضافية settings block with IP allowlists, supported protocols, and default geo params.

GET/api/v1/packages/{id}

package-show.json

{
  "data": {
    "id":           12,
    "name":         "Residential 10 GB",
    "type":         "residential",
    "status":       "active",
    "pool_type":    "residential",
    "quota_gb":     10.0,
    "used_gb":      3.2140,
    "available_gb": 6.7860,
    "usage_pct":    32.14,
    "blocked":      false,
    "synced_at":    "2026-05-29T11:00:00+00:00",
    "created_at":   "2026-04-01T11:59:00+00:00",
    "activated_at": "2026-04-01T12:00:00+00:00",
    "proxy": {
      "host":              "proxy.raxyproxy.com",
      "http_port":         823,
      "socks5_port":       824,
      "login":             "abc123def456",
      "password":          "6f487b213b4cb4ae",
      "threads":           100,
      "sticky_port_start": 10000,
      "sticky_port_end":   20000,
      "sticky_range":      { "start": 10000, "end": 20000 }
    },
    "settings": {
      "allowed_ips":         [],
      "supported_protocols": ["http", "socks5"],
      "blocked_hosts":       [],
      "default_geo": {
        "countries":         [],
        "states":            [],
        "cities":            [],
        "zipcodes":          [],
        "asns":              [],
        "exclude_countries": [],
        "exclude_asn":       [],
        "anonymous_filter":  false,
        "rotation_interval": null
      }
    }
  },
  "meta": { "version": "v1" }
}

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

الحقل	النوع	الوصف
`id`	integer	معرّف الحزمة — يُستخدم في استدعاءات API أخرى
`name`	string	اسم المنتج المقروء للإنسان
`type`	string	`residential` \| `residential_premium` \| `mobile` \| `datacenter`
`status`	string	`active` \| `suspended`
`pool_type`	string	معرّف داخلي للمجموعة (residential، residential_premium، mobile، datacenter)
`quota_gb`	float	إجمالي حركة المرور المشتراة بـ GB
`used_gb`	float	حركة المرور المستهلكة حتى الآن
`available_gb`	float	حركة المرور المتبقية
`usage_pct`	float	النسبة المئوية المستخدمة (0–100)
`blocked`	boolean	true عند حظر الحزمة إداريًا
`synced_at`	ISO 8601 \| null	آخر مزامنة لعدّادات الاستخدام من المزوّد (≤30 دقيقة تأخر)
`created_at`	ISO 8601	وقت إنشاء سجل الحزمة
`activated_at`	ISO 8601 string	متى تم تفعيل الحزمة لأول مرة
`proxy.host`	string	اسم مضيف الوكيل
`proxy.http_port`	integer	منفذ وكيل HTTP/HTTPS (823)
`proxy.socks5_port`	integer	منفذ SOCKS5 (824)
`proxy.login`	string	اسم مستخدم الوكيل (الأساسي، بدون معدِّلات جغرافية)
`proxy.password`	string (show only)	كلمة مرور الوكيل بصيغة نصية — تُعاد فقط من GET /packages/{id} (نقطة التفاصيل). احتفظ بها سرًّا.
`proxy.threads`	integer	الحد الأقصى للاتصالات المتزامنة
`proxy.sticky_port_start`	integer	أول منفذ لجلسة ثابتة
`proxy.sticky_port_end`	integer	آخر منفذ لجلسة ثابتة
`proxy.sticky_range`	object	نطاق منافذ الجلسات الثابتة، مكرَّر كائنياً للـ SDK التي تفضّل الكائنات
`settings.allowed_ips`	array	قائمة IPs المسموح بها (فارغة = أي IP مسموح)
`settings.supported_protocols`	array	البروتوكولات الممكّنة لهذه الحزمة
`settings.blocked_hosts`	array	النطاقات المحظورة على الحزمة (قائمة كاملة)
`settings.default_geo`	object	فلتر جغرافي افتراضي (كائن يحوي countries/states/cities/zipcodes/asns + exclude_* + anonymous_filter + rotation_interval).

أمثلة الكود

packages.sh

# List all packages
curl https://raxyproxy.com/api/v1/packages \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Get a single package
curl https://raxyproxy.com/api/v1/packages/12 \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

packages.py

import requests

API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

# List packages
pkgs = requests.get('https://raxyproxy.com/api/v1/packages', headers=HEADERS).json()

for p in pkgs['data']:
    pct = p['usage_pct']
    print(f"[{p['id']}] {p['name']}  {p['used_gb']}/{p['quota_gb']} GB ({pct}%)")

packages.mjs

const API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const headers = { Authorization: `Bearer ${API_KEY}` };

const res  = await fetch('https://raxyproxy.com/api/v1/packages', { headers });
const json = await res.json();

for (const p of json.data) {
    const { id, name, used_gb, quota_gb, usage_pct } = p;
    console.log(`[${id}] ${name}  ${used_gb}/${quota_gb} GB (${usage_pct}%)`);
}

← السابق

الحساب

إحصائيات الحزمة