الحساب
Docsالحساب

الحساب

احصل على تفاصيل الحساب والرصيد وإجماليات حركة المرور ومعلومات مفتاح API المستخدم.

GET /account

يُرجع ملف الحساب والرصيد بالدولار وعدد الحزم وحركة المرور لآخر 30 يومًا وبيانات مفتاح API.

GET/api/v1/account

Authentication: مطلوب Bearer Token.

Parameters: لا شيء.

response.json
{
  "data": {
    "id":                 4823,
    "email":              "user@example.com",
    "balance_usd":        24.7500,
    "packages_active":    3,
    "packages_total":     4,
    "total_used_gb_30d":  127.4192,
    "member_since":       "2026-01-15T08:32:00+00:00",
    "api_key": {
      "name":         "ci-pipeline",
      "prefix":       "raxy_xY",
      "scopes":       null,
      "last_used_at": "2026-05-29T11:04:12+00:00",
      "expires_at":   null
    }
  },
  "meta": { "version": "v1" }
}

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

الحقلالنوعالوصف
emailstringالبريد الإلكتروني للحساب.
balance_usdfloatرصيد المحفظة الحالي بالدولار (4 منازل عشرية).
packages_activeintegerالحزم بحالة active.
packages_totalintegerالحزم النشطة + الموقوفة.
total_used_gb_30dfloatإجمالي حركة المرور خلال آخر 30 يومًا، بالـ GB.
member_sincestringطابع زمني للتسجيل (ISO 8601).
api_keyobject | nullبيانات مفتاح API المستخدم — انظر أدناه.

معلومات مفتاح API

يفيد في تحديد المفتاح المُستخدم، فحص الـ scopes وتاريخ الانتهاء — مفيد لدورات التدوير والتدقيق.

api_key.json
{
  "name":         "ci-pipeline",
  "prefix":       "raxy_xY",
  "scopes":       ["farm"] | null,
  "last_used_at": "2026-05-29T11:04:12+00:00",
  "expires_at":   "2026-08-01T00:00:00+00:00" | null
}

أمثلة الكود

account.sh
curl https://raxyproxy.com/api/v1/account \
     -H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
account.py
import requests

resp = requests.get(
    'https://raxyproxy.com/api/v1/account',
    headers={'Authorization': 'Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'},
    timeout=10,
)
data = resp.json()['data']
print(f"Balance: ${data['balance_usd']:.2f} — 30d traffic: {data['total_used_gb_30d']} GB")
account.mjs
const resp = await fetch('https://raxyproxy.com/api/v1/account', {
    headers: { Authorization: 'Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' },
});
const { data } = await resp.json();
console.log(`Balance $${data.balance_usd.toFixed(2)} — 30d traffic ${data.total_used_gb_30d} GB`);