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

استعلم عن تاريخ استخدام حركة المرور لحزمة وكيل حسب الفترة.

GET /packages/:id/stats

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

GET/api/v1/packages/{id}/stats

معاملات الاستعلام

المعامل	الافتراضي	الخيارات
`period`	`30d`	`7d` · `30d` · `90d` · `1y` · `day` · `week` · `month` · `3months` · `6months` · `year`
`aggregate`	`day`	`minute` · `hour` · `day`. حجم الحاوية لسلسلة التاريخ. minute مسموح فقط مع period=7d أو day.

stats-request.sh

curl "https://raxyproxy.com/api/v1/packages/12/stats?period=7d" \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

stats-response.json

{
  "data": {
    "package_id":   12,
    "period":       "7d",
    "aggregate":    "day",
    "quota_gb":     10.0,
    "used_gb":      3.2140,
    "available_gb": 6.7860,
    "usage_pct":    32.14,
    "history": [
      { "datetime": "2026-05-09",       "traffic_gb": 0.512100, "requests": 4820 },
      { "datetime": "2026-05-10",       "traffic_gb": 0.480300, "requests": 4612 },
      { "datetime": "2026-05-11",       "traffic_gb": 0.631200, "requests": 5901 },
      { "datetime": "2026-05-12",       "traffic_gb": 0.390000, "requests": 3741 },
      { "datetime": "2026-05-13",       "traffic_gb": 0.520000, "requests": 4900 },
      { "datetime": "2026-05-14",       "traffic_gb": 0.441200, "requests": 4210 },
      { "datetime": "2026-05-15",       "traffic_gb": 0.239188, "requests": 2390 }
    ]
  },
  "meta": { "version": "v1" }
}

With aggregate=hour or aggregate=minute the datetime values include time-of-day, for example 2026-05-15T14:00:00+00:00.

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

الحقل	النوع	الوصف
`package_id`	integer	الحزمة التي تنتمي إليها هذه البيانات
`period`	string	الفترة المطلوبة (مُعادة)
`quota_gb`	float	إجمالي حركة المرور المشتراة
`used_gb`	float	إجمالي حركة المرور المستهلكة
`available_gb`	float	حركة المرور المتبقية
`usage_pct`	float	النسبة المئوية المستهلكة
`aggregate`	string	minute · hour · day
`history[].datetime`	string	يوم التقويم
`history[].traffic_gb`	float	حركة المرور المستخدمة في ذلك اليوم بـ GB
`history[].requests`	integer	عدد طلبات الوكيل في تلك الحاوية

تقسيم حركة المرور حسب المضيف (أعلى N وجهات) متاح في /api/v1/packages/{id}/stats/hosts.

أحداث الأخطاء الحديثة (4xx/5xx/المهلات) متاحة في /api/v1/packages/{id}/stats/errors.

أمثلة الكود

stats.py

import requests

API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12

resp = requests.get(
    f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/stats',
    params={'period': '30d'},
    headers={'Authorization': f'Bearer {API_KEY}'},
    timeout=10,
).json()

data = resp['data']
print(f"Used {data['used_gb']} / {data['quota_gb']} GB ({data['usage_pct']}%)")

for bucket in data['history']:
    print(f"  {bucket['datetime']}: {bucket['traffic_gb']:.4f} GB  {bucket['requests']} requests")

stats.mjs

const API_KEY    = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const PACKAGE_ID = 12;

const url  = `https://raxyproxy.com/api/v1/packages/${PACKAGE_ID}/stats?period=30d`;
const resp = await fetch(url, {
    headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data } = await resp.json();

console.log(`Used ${data.used_gb} / ${data.quota_gb} GB (${data.usage_pct}%)`);

for (const day of data.history) {
    console.log(`  ${day.datetime}: ${day.traffic_gb.toFixed(4)} GB  ${day.requests} requests`);
}

← السابق

الحزم

قائمة الوكلاء

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

GET /packages/:id/stats

معاملات الاستعلام

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

نقاط النهاية ذات الصلة

أمثلة الكود