API
واجهة API صغيرة وصارمة وموثّقة .
بإصدارات تحت /api/v1. العقد المرجعي هو مواصفة OpenAPI؛ ويفشل اختبار إذا اختلف أي مسار عن المواصفة.
فتح openapi.yamlبداية سريعة (بيئة تجريبية)
bash
# 1. عرض الألعاب
curl -H "Authorization: Bearer $KEY" https://nextgensoftware.org/api/v1/games
# 2. إطلاق (محاكى)
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"player_id":"u1","currency":"XTS"}' https://nextgensoftware.org/api/v1/games/GAME_ID/launch
# 3. رهان (المبلغ بوحدات صغرى؛ transaction_id هو مفتاح التكرار)
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"player_id":"u1","currency":"XTS","transaction_id":"bet-1","amount":1000,"game_id":"GAME_ID","round_id":"r1"}' https://nextgensoftware.org/api/v1/wallet/betالمال
أعداد صحيحة بوحدات صغرى. لا كسور ولا نصوص ولا أعداد عائمة.
اتساق التنفيذ
transaction_id فريد لكل مشغّل؛ وتُعيد إعادة الإرسال النتيجة الأصلية.
الأخطاء
غلاف ثابت برموز مقروءة آليًا ومعرّف ربط.
تُصدَر مفاتيح API للمشغّلين في بوابة المشغّل بعد الإعداد.