توثيق API

المطوّرون

توثيق API

واجهة برمجة تطبيقات RESTful وإشعارات WebSocket وبيئة اختبار وضع الحماية.

RESTful API
RESTful API

إدارة المستخدمين وجلسات اللعب والإيداع والسحب. تستخدم جميع نقاط النهاية تنسيق JSON.

WebSocket
WebSocket

إشعارات فورية بتحديثات الرصيد ونتائج الألعاب.

بيئة الاختبار
بيئة الاختبار

التطوير الآمن باستخدام بيانات الاختبار. اختبر التدفق بالكامل قبل بدء البث المباشر.

أمثلة نقاط النهاية

POST/api/v1/usersقم بإنشاء مستخدم جديد
GET/api/v1/users/{id}معلومات المستخدم
PUT/api/v1/users/{id}/balanceتحديث الرصيد
POST/api/v1/users/{id}/sessionابدأ الجلسة
const res = await fetch(
  'https://api.softagon.net/v1/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      username: 'player123',
      currency: 'EUR',
      country: 'DE'
    })
  }
);
const user = await res.json();

التفاصيل

رموز الخطأ وأفضل الممارسات

السيناريوهات الأكثر شيوعًا وخطوات الحل الموصى بها أثناء التكامل.

الكودالمعنىتوصية
AUTH_401طلب غير مصرح به / مفتاح غير صالحتحقق من مفتاح API والقائمة البيضاء لـ IP
RATE_429تم تجاوز حد الطلباتأعد المحاولة مع زيادة مهلة الانتظار واستخدم الطلبات المجمّعة
WALLET_409العملية المتكررة / تعارض العجزيجب أن يكون معرف المعاملة فريدًا
SESSION_410انتهت صلاحية الجلسةأنشئ جلسة جديدة وأعد فتح اللعبة
PROV_503الموفر غير متاح مؤقتًاعرض الموفر الاحتياطي/بث اللعبة
CONFIG_422تكوين غير كامل/غير متوافقتحقق من إعدادات التاجر/المزود
TIMEOUT_504انتهت مهلة استجابة الخدمة الخارجيةأعد المحاولة بعد مهلة وتحقّق من النتيجة عبر نقطة نهاية الحالة
العجز الجنسي
العجز الجنسي

لا يتم تطبيق نفس المعاملة مرتين في نقاط نهاية الدفع والمحفظة. تعد استراتيجية معرف المعاملة أمرًا بالغ الأهمية.

الأمان
الأمان

إدارة الوصول باستخدام HTTPS إلزامية وتناوب المفاتيح ومبدأ الامتيازات الأقل.

خطاف الويب

استخدم توقيع التحقق للدفع وأحداث اللعبة، وقم بتعيين سياسة إعادة المحاولة والمهلة.

{
  "id": "evt_01HXYZ...",
  "type": "payment.succeeded",
  "created_at": "2026-01-01T12:34:56Z",
  "data": {
    "merchant_id": "m_123",
    "tx_id": "tx_789",
    "amount": 100.00,
    "currency": "EUR",
    "status": "succeeded"
  }
}

الأسئلة الشائعة

الأسئلة الشائعة للمطورين

إجابات سريعة عن بيئة الاختبار ومفاتيح API ومسار التكامل.

يعمل مع بيانات اختبار وضع الحماية وليس له أي تأثير مالي. يتم نشر الدفع الحقيقي وتدفقات المزودين في البيئة الحية.

تتم مطابقة رأس التوقيع وتجزئة الحمولة. في حالة التوقيع غير الصحيح، يتم رفض الطلب وتسجيله.

تنفيذ إعادة المحاولة مع التراجع الأسي. إذا أمكن، قم بإدارة طلبات الكتالوج/التقرير عبر الدفعة أو ذاكرة التخزين المؤقت.

قد تنتهي الجلسة بانتهاء مدة صلاحيتها أو تسجيل خروج المستخدم أو انتهاء مهلة المزوّد. أنشئ جلسة جديدة وأعد توجيه المستخدم إلى اللعبة.

ابدأ البث المباشر مع Softagon
إدارة البنية التحتية والتكامل وإدارة المكتب الخلفي لعمليات الكازينو والمراهنات الرياضية في لوحة واحدة.
S
Softagon

البرمجيات التي تدعم علامات المراهنات. تربط المنتج بإدارة العمليات.

SOFTAGON

© 2026 Softagon. جميع الحقوق محفوظة.

لنخطط لمشروعك معًا

قم بإنشاء موقع ويب مجاني باستخدام Framer، أداة إنشاء مواقع الويب المحبوبة من قبل الشركات الناشئة والمصممين والوكالات.