الوثائق / سيناريو الألعاب

سيناريو API للألعاب

المسار الكامل من التحقق من اللاعب وتشغيل اللعبة إلى معالجة الرهانات والأرباح وجولات اللعب وإلغاء العمليات والتسوية المالية.

تكامل واجهات API للألعاب
الجلسة
اللاعب وتشغيل اللعبة
الرصيد
الرهانات والأرباح
الجولات
سير جلسة اللعب
الإلغاء
استعادة العمليات
دورة حياة اللعبة

من التشغيل إلى إغلاق الجولة

01
إنشاء جلسة لعب

اللاعب واللعبة والعملة واللغة والبلد والوضع وعنوان العودة.

02
تشغيل اللعبة

مفتاح وصول مؤقت وعنوان التشغيل والتحقق من توفر اللعبة.

03
معالجة العمليات المالية

فحص الرصيد والرهان والربح والعملية المجمعة واستجابات المنصة.

04
إغلاق الجولة وتسويتها

النتيجة النهائية والإلغاءات والسجل المالي وتقرير المزود.

نظرة عامة

يربط API الألعاب بين اللاعب والجولة وحركة الأموال

تشغيل اللعبة وحركة الأموال جزآن مختلفان من عملية واحدة. تحدد الجلسة اللاعب وشروط التشغيل، وتربط الجولة إجراءات المزود، بينما يؤكد API المنصة كل خصم وإضافة وإلغاء.

بيانات جلسة اللعب

اللاعب والعلامة التجارية واللعبة والعملة والبلد واللغة والوضع والولاية القضائية ومدة صلاحية الوصول.

التحكم في الرصيد

تتحقق المنصة من الأموال المتاحة وتطبق كل رهان أو دفع أو إلغاء مرة واحدة فقط.

السجل المالي للعبة

تُحفظ معرفات العملية والجولة ونوع العملية والمبلغ والرصيد قبل وبعد لأغراض المراقبة والتسوية.

تشغيل اللعبة

سيناريو نموذجي لتشغيل اللعبة

تتحقق المنصة أولًا من اللاعب وتوفر اللعبة، ثم تنشئ جلسة محددة المدة وتحصل على عنوان التشغيل من المزود.

01

التحقق من اللاعب وتوفر اللعبة

تتحقق المنصة من حالة الحساب والعملة والبلد والقيود والحدود والوضع الحقيقي أو التجريبي وتوفر اللعبة.

02

إنشاء جلسة داخلية

يتم إنشاء معرف جلسة يتضمن بيانات اللاعب واللعبة والعلامة التجارية والعملة واللغة وIP ومدة الصلاحية.

03

الحصول على عنوان تشغيل اللعبة

يتلقى المزود مفتاح الجلسة وعناوين الإشعارات والعودة ونوع الجهاز والولاية القضائية ومعلمات الواجهة.

04

فتح اللعبة في المتصفح

يفتح اللاعب العنوان المستلم، وتتم العمليات المالية اللاحقة مباشرة بين الخوادم.

عمليات الرصيد

العمليات الأساسية للرصيد

تختلف أسماء الطرق بين المزودين، لكن المنطق يبقى واحدًا: فحص الرصيد وخصم الرهان وإضافة الربح وإلغاء عملية سبق تأكيدها.

فحص الرصيد

يعيد رصيد اللاعب المتاح بعملة الجلسة النشطة دون تغيير السجل المالي.

خصم الرهان

يتحقق من اللاعب والجلسة والعملة والأموال المتاحة، ثم يخصم الرهان المؤكد مرة واحدة.

إضافة الربح

يضيف الربح باستخدام معرفات فريدة للعملية والجولة، بما في ذلك النتيجة الصفرية.

الرهان والنتيجة في طلب واحد

يطبق الرهان ونتيجة اللعبة في الوقت نفسه عندما يدعم المزود هذا المخطط.

إلغاء العملية

ينشئ عملية تصحيح منفصلة لرهان أو دفعة سبق تأكيدها دون حذف القيد الأصلي.

المكافآت والدورات المجانية

ينقل بيانات حملة المكافأة وجولة اللعب مع فصل الأموال الحقيقية عن أموال المكافآت.

العملة ودقة المبلغ

تتحقق كل عملية من العملة ووحدات المبلغ وعدد المنازل العشرية وقواعد التقريب.

استجابة المنصة

تعيد حالة العملية ومعرفها الداخلي والرصيد الحالي ورمز خطأ موحد.

دورة حياة الجولة

دورة حياة جولة اللعب

يمكن أن تتضمن الجولة الواحدة عدة رهانات ونتائج. تحدد قواعد اللعبة حالتها، وليس ترتيب طلبات الشبكة فقط.

تم إنشاء الجولة

تتلقى المنصة معرف الجولة لأول مرة وتنشئ سجلًا داخليًا.

الجولة نشطة

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

تم قبول الرهان

أكدت المنصة الخصم وربطته بمعرف فريد لعملية المزود.

تم استلام النتيجة

تم استلام ربح أو نتيجة صفرية، لكن قد تبقى الجولة مفتوحة وفق قواعد اللعبة.

تم إغلاق الجولة

أكد المزود انتهاء الجولة وتمت معالجة جميع العمليات المالية المتوقعة.

تم إلغاء العمليات

تم تصحيح عملية واحدة أو أكثر مع الاحتفاظ بالسجل الأصلي الكامل.

قد تتضمن الجولة الواحدة عدة عمليات

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

الموثوقية والتسوية

الحماية من التكرار والتسوية المالية

يجب أن يعالج API الألعاب بأمان الطلبات المكررة وتأخيرات الاستجابة وتغير ترتيب العمليات واستعادة المزود بعد العطل.

معالجة مكررة آمنة

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

سجل الجولات والتسوية

احتفظ بمعرفات الجلسة والجولة وعملية المزود وعملية المنصة.
سجل نوع العملية والمبلغ والعملة والرصيد قبل وبعد ووقت المعالجة.
لا تعدل القيود المنفذة، بل أنشئ عملية تصحيح منفصلة.
طابق تقارير المزود وجولات اللعب وحركة الرصيد وGGR والفروقات المكتشفة.
الاختبار

ما يجب اختباره في بيئة الاختبار

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

التشغيل وجلسة اللعب

الوضعان الحقيقي والتجريبي والعملة غير الصحيحة والبلد المحظور والوصول المنتهي واللعبة غير المتاحة.

الرصيد ورفض الرهان

أموال غير كافية أو لاعب محظور أو عدم تطابق العملة أو تجاوز الحد.

التأخير والنتيجة غير المعروفة

لم يتلق المزود استجابة بعد الخصم الفعلي، فأعاد إرسال العملية بالمعرف نفسه.

الرهانات والأرباح المكررة

يصل المعرف نفسه قبل أو بعد اكتمال المعالجة، بما في ذلك معلمات متعارضة.

إلغاء العمليات

إلغاء رهان وإلغاء ربح وإلغاء مكرر وإشارة إلى عملية أصلية غير معروفة.

تسوية الجولة

يجب أن تتطابق مبالغ الرهانات والأرباح والإلغاءات والحالة النهائية وحركة الرصيد وتقرير المزود.

قائمة تحقق قبل الإطلاق

يتم الإطلاق بعد التحقق من جلسات اللعب وعمليات الرصيد والحماية من التكرار والإلغاءات والتقارير.

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

هل تحتاج إلى إعداد سيناريو API للألعاب؟

أرسل وثائق المزود وقائمة عمليات الرصيد ونموذج جولات اللعب والعملات ومتطلبات التقارير. سيساعد APIACE في تنظيم تشغيل اللعبة والرهانات والأرباح والإلغاءات والتسوية المالية.