REST API · v1
أدوات المطورين
اربط نظامك مع RadiusX عبر واجهة برمجية آمنة (REST/JSON): أنشئ حسابات إنترنت، تحكّم بالجلسات الحيّة، واقرأ الاستهلاك — بمفتاح واحد لكل شبكة.
مفتاح لكل شبكة
كل شبكة تستخرج مفتاح ربط (Bearer) من لوحتها، ويُدخَل في نظامك — المفتاح وحده يحدّد الشبكة ويعزلها عن غيرها.
تفعيل فوري
أنشئ مشتركاً باسم مستخدم وكلمة مرور فيشتغل مباشرة على شبكة الهوتسبوت — بدون أي تدخّل يدوي.
استهلاك لحظي
اقرأ البيانات المستهلكة (رفع/تنزيل)، وقت الجلسة، الحالة، والمتبقي — محدّثة دورياً ولحظياً عند انتهاء الجلسة.
تحكّم بالجلسة
افصل مشتركاً نشطاً فوراً عبر CoA (RFC 5176)، أو أوقفه فيُفصل ويُمنع تلقائياً — مع فرض الكوتا والصلاحية.
أهم النقاط (Endpoints)
القاعدة: https://radiusx.link/api/v1 — المصادقة: Authorization: Bearer rxk_…
GET/profilesكتالوج الباقات (السرعة/الكوتا/الصلاحية)
POST/subscribersإنشاء وتفعيل حساب
GET/subscribers/{id}الحالة والاستهلاك
PATCH/subscribers/{id}إيقاف / تعديل الباقة أو الكوتا أو الصلاحية
DEL/subscribers/{id}حذف الحساب وفصل الجلسة
POST/subscribers/{id}/disconnectفصل فوري للجلسة
مثال سريع
إنشاء مشترك يستخدم بياناته مباشرةً في صفحة دخول الهوتسبوت:
# create a subscriber curl -X POST https://radiusx.link/api/v1/subscribers \ -H "Authorization: Bearer rxk_…" \ -H "Content-Type: application/json" \ -d '{ "username": "u-1001", "password": "s3cret", "profile_id": 70, "quota_bytes": 1073741824, "expires_at": "2026-08-31T23:59:59+03:00", "external_ref": "CARD-001" }'
Webhooks: نُشعر نظامك لحظياً عند نفاد الكوتا أو انتهاء الصلاحية أو الاتصال/الانقطاع، برسائل موقّعة (HMAC) وإعادة محاولة.