قائمة فحص ربط casino API: ما تبنيه وتختبره وتراقبه قبل الإطلاق

آخر مراجعة 2026-10-09

يفشل ربط API ألعاب الكازينو في مواضع متوقعة: خصم أُعيد إرساله فاحتُسب مرتين، أو rollback لرهان لم تستلمه أصلًا، أو عملة بثلاث خانات عشرية. تمرّ هذه القائمة على كل طبقة بالترتيب الذي يصادفه المطوّر، مع العطل الذي يمنعه كل فحص.

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

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

0. قبل أول سطر من الكود

• لديك وثائق API كاملة، لا ملف PDF تسويقي: كل endpoint، وكل رمز خطأ، وأمثلة على الحمولات.
• تعرف نموذج المحفظة. seamless (المزوّد يستدعي خادمك عند كل رهان وكل ربح) أو transfer (تنقل الأموال إلى رصيد لدى المزوّد). تفترض هذه القائمة نموذج seamless، وهو ما تبيعه معظم المجمّعات.
• بيانات اعتماد بيئة الاختبار (staging) ورابط callback الخاص بها منفصلان عن الإنتاج.
• توقيع الطلبات واضح: أي header، وأي خوارزمية (غالبًا HMAC-SHA256)، وأي حقول موقّعة، وبأي ترتيب.
• تعرف عناوين IP الصادرة من المزوّد، إن كان يريد منك إضافتها إلى قائمة السماح.
• لديك جهة اتصال تقنية بالاسم وقناة تردّ خلال ساعات.

1. callbacks المحفظة

سيستدعي المزوّد خادمك لأربعة أمور. ابنِها قبل أي شيء آخر.

• الرصيد (Balance). يعيد الرصيد القابل للإنفاق حاليًا بعملة اللاعب.
• الخصم (Debit، الرهان). يخصم قيمة الرهان إن سمح الرصيد، ويعيد الرصيد الجديد. نقص الرصيد يعيد رمز الخطأ الموثّق، لا خطأ 500.
• الإضافة (Credit، الربح). يضيف الربح. الإضافة بقيمة صفر صحيحة ويجب أن تنجح؛ كثير من الاستوديوهات ترسلها لإغلاق جولة خاسرة.
• الـRollback (الاسترداد). يلغي خصمًا سابقًا محددًا.
• كل رد موقّع أو متحقَّق منه بالطريقة التي تشترطها الوثائق.
• تتحقق من التوقيع الوارد في كل طلب وترفض الطلبات غير الصالحة بالرمز الموثّق.
• يجيب الـendpoint لديك قبل مهلة المزوّد بفارق مريح. ابحث عن الرقم في الوثائق. إن كان 3 ثوانٍ، فاستهدف أقل من 300 ms عند الشريحة المئوية 99.
• المبالغ مخزّنة كأعداد صحيحة بالوحدات الصغرى أو كأعداد عشرية بفاصلة ثابتة. لا كأعداد float أبدًا.
• الخصم والإضافة يحملان معرّف الجولة ومعرّف اللعبة. خزّن الاثنين.

سيناريو. لاعب على اتصال جوال بطيء يدير البكرات. ينجح الخصم لديك، لكن الرد يستغرق 4 ثوانٍ والمزوّد يستسلم عند 3. الآن يرسل المزوّد rollback، أو يعيد إرسال الخصم، بحسب قواعده. القسمان 2 و3 موجودان لهذه اللحظة بالذات.

2. الـIdempotency

• هناك قيد فريد (unique constraint) على معرّف المعاملة لدى المزوّد في جدول المعاملات لديك.
• الخصم أو الإضافة المكرر بالمعرّف نفسه لا يحرّك المال مرة أخرى، بل يعيد الرد الأصلي بقيم الرصيد نفسها.
• الطلب المكرر بالمعرّف نفسه لكن بمبلغ مختلف يُرفض ويُسجَّل بتنبيه واضح. فهذا إما خلل لدى المزوّد أو هجوم.
• تغييرات الرصيد وإدراج المعاملات تتم في معاملة قاعدة بيانات واحدة. لا توجد لحظة يوجد فيها أحدهما دون الآخر.
• الطلبات المتزامنة للاعب نفسه تُنفَّذ بالتسلسل (قفل صف أو ما يعادله). خصمان متزامنان من تبويبين مفتوحين لا يجوز أن يمرّا كلاهما على رصيد لا يغطي إلا واحدًا.

3. الـRollback

• يشير الـrollback إلى الخصم الذي يلغيه. ابحث عنه بمعرّف المعاملة لدى المزوّد.
• rollback لخصم لم تستلمه قط: سجّله كعلامة (tombstone) وأعد النجاح (أو الرمز الموثّق). إن وصل الخصم لاحقًا، تمنعك العلامة من احتسابه.
• rollback لخصم أُلغي سابقًا يعيد الرد الأصلي.
• rollback لخصم سُجّل ربح في جولته بالفعل: اتبع الوثائق حرفيًا. بعض المزوّدين يمنعه، وبعضهم يتوقع منك إلغاء الاثنين.
• الـrollback لا يدفع الرصيد أبدًا إلى حالة غير مفسَّرة. إن كان قد يجعله سالبًا، فحدّد القاعدة الآن ودوّنها.

4. الجولات والألعاب غير المكتملة

• يمكنك رؤية الجولات المفتوحة (خصم مستلم بلا إضافة ختامية).
• تعرف كيف يغلق المزوّد الجولات المعلّقة: إضافة تلقائية بعد مهلة، أو أداة يدوية، أو تذكرة دعم.
• أرباح البونص والدورات المجانية موسومة كي يتعامل منطق البونص لديك معها بشكل مختلف عن الأرباح النقدية.
• الباك أوفيس لديك يعرض سجل الجولات كاملًا لكل لاعب: كل طلب، وكل رد، والطوابع الزمنية.

5. العملات

• لكل لاعب عملة واحدة ثابتة، تُحدَّد عند التسجيل، وتُرسَل عند الإطلاق، وتتكرر في كل callback.
• تتحقق من أن عملة الـcallback تطابق عملة اللاعب، وترفض أي عدم تطابق.
• عدد الخانات العشرية صحيح لكل عملة. معظم العملات الورقية تستخدم خانتين، وبعضها صفرًا، وبعضها ثلاثًا. والكريبتو قد تستخدم ثماني خانات أو أكثر؛ اتفق مع المزوّد على الدقة المستخدمة في الإرسال.
• كل لعبة تعرضها تدعم فعلًا العملة التي تعرضها بها. قد يدعم استوديو EUR وUSD لكن لا يدعم BDT أو ETB.
• حدود الرهان لكل عملة منطقية. حد أدنى صغير باليورو قد يبدو غريبًا بالـIDR أو ضخمًا بالـBTC.
• لا خلط في التقارير بين عملة العرض وعملة التسوية.

6. مزامنة قائمة الألعاب

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

7. روابط الإطلاق

• الإطلاق بأموال حقيقية يمرّر رمز جلسة قصير العمر مرتبطًا باللاعب. لا كلمة مرور ولا معرّفًا قابلًا لإعادة الاستخدام أبدًا.
• انتهاء صلاحية الرمز مُعالَج: التبويب القديم يعرض رسالة واضحة، لا إطارًا معطوبًا.
• اللغة والعملة ونوع الجهاز ورابط العودة/اللوبي تُضبط عند الإطلاق.
• يُمرَّر رابط الإيداع أو الكاشير حيث تدعمه اللعبة، كي تقود رسالة «رصيد غير كافٍ» إلى مكان ما.
• تفتح اللعبة بشكل صحيح داخل iframe وفي نافذة جديدة. بعض الاستوديوهات تحجب iframe على نطاقات أو متصفحات معينة.
• إطلاقات الوضع التجريبي، إن وُجدت، لا تلمس المحفظة الحقيقية أبدًا. اختبر ذلك صراحةً.
• زمن الإطلاق من النقرة حتى أول إطار مقيس على هاتف متوسط الفئة عبر 4G. ما يتجاوز 5 ثوانٍ يخسرك لاعبين.

8. الاختبار

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

9. الإطلاق

• مفاتيح الإنتاج ورابط callback مُبدَّلان، وبيئة الاختبار معطّلة للاعبي الإنتاج.
• مراقبة زمن استجابة callbacks ومعدل الأخطاء وإخفاقات التوقيع، مع تنبيهات تصل إلى شخص، لا إلى لوحة لا يفتحها أحد.
• مهمة مطابقة يومية: إجمالياتك لكل لعبة ولكل عملة مقابل إجماليات المزوّد.
• في النماذج المسبقة الدفع، تنبيه انخفاض الرصيد المسبق قبل الصفر بمسافة كافية، وشخص يستطيع الشحن يوم الأحد.
• مفتاح إيقاف لكل لعبة ولكل استوديو في الباك أوفيس.
• قناة دعم المزوّد وجهة التصعيد مدوّنتان في دليل التشغيل لديك.

10. الأيام السبعة الأولى

• افحص المطابقة كل صباح.
• راجع كل callbacks المرفوضة والجولات المفتوحة.
• راقب أخطاء الإطلاق لكل استوديو؛ استوديو واحد سيئ قد يجرّ اللوبي كله إلى الأسفل.
• اطلب من المزوّد سجلات الأخطاء من جهته وقارنها بسجلاتك.

يستطيع فريق صغير يطلق علامة كريبتو أن ينجز هذه القائمة في أسبوع إن كانت وثائق المزوّد متينة. وإن كانت الوثائق ضعيفة، فالقائمة اختبار جيد للمزوّد أيضًا: احسب عدد البنود التي اضطررت للسؤال عنها. تصنيف مجمّعات seamless wallet وصفحة المجمّعات للمشغّلين الجدد يقيّمان المزوّدين على هذا النوع من أعمال الربط تحديدًا.