जैकपॉट एपीआई कैसे काम करता है

पूरा लेख

💡 18+. सामग्री इंजीनियरिंग-लागू है, खेलने के लिए कॉल के बिना। शर्तें: मंच - पीएएम/बटुआ/नकद डेस्क/बोनस/आरजी; आरजीएस - रिमोट गेम सर्वर (स्टूडियो गेम्स का कोर); एग्रीगेटर - कई आरजीएस के लिए एकीकृत परत; जेपी - जैकपॉट सेवा।

1) जैकपॉट सिस्टम क्या है और यह पारिस्थितिकी तंत्र में कहां खड़ा है

जैकपॉट सिस्टम एक अलग सेवा (कभी-कभी सेवाओं का एक समूह) है जो दांव से योगदान एकत्र करता है, पूल का प्रबंधन करता है और ट्रिगर जीतता है, पुरस्कारों के वितरण की गणना करता है और ऑपरेटर के भुगतान लूप के माध्यम से भुगतान शुरू करता है। यह एकीकृत करता है:

आरजीएस (दरों/परिणामों और योग्यता के बारे में संदेश) के साथ, एक प्लेटफ़ॉर्म/वॉलेट (योगदान और क्रेडिट जीत) के साथ, एक एग्रीगेटर (कई स्टूडियो/ब्रांडों से रूटिंग) के साथ, एक बीआई/नियामक (टेलीमेट्री और रिपोर्टिंग)।

2) जैकपॉट के प्रकार (और एपीआई में क्या परिवर्तन)

1. फिक्स्ड-पहले से ज्ञात पुरस्कार की राशि। एपीआई में कोई पूल नहीं है, केवल शर्त की जाँच और क्रेडिट।

2. प्रगतिशील: पूल शर्त योगदान से बढ़ ता है। हमें योगदान और वर्तमान आकार के प्रकाशन के समापन बिंदुओं की आवश्यकता है।

3. मल्टी-टियर (मल्टी-टियर: मिनी/मेजर/ग्रैंड): विभिन्न बाधाओं और कैप के साथ कई समानांतर पूल।

4. स्थानीय बनाम नेटवर्क: स्थानीय पूल - एक ऑपरेटर/ब्रांड नेटवर्क - कई ऑपरेटरों/ब्रांडों/क्षेत्रों के लिए कुल (बहु-किरायेदारी और प्रतिकृति महत्वपूर्ण हैं)।

5. समय/घटना: समय सीमा के साथ या अनुसूची पर एक पूल (टाइमर और ऑटो-ड्रॉ की आवश्यकता होती है)।

3) मौद्रिक अपरिवर्तनीय

संतुलन पर सत्य का स्रोत मंच का बटुआ/बही है। जेपी केवल पूल और देनदारियों की स्थिति को संग्रहीत करता है।

सभी धन लेनदेन अज्ञात हैं (कुंजियाँ 'jp _ curb _ id', 'jp _ triger _ id', 'jp _ paut _ id')।

खोया/डुप्लिकेटेड पेआउट = 0। मुआवजा - केवल घटनाओं (सागा) द्वारा, मैनुअल डेटाबेस संपादन द्वारा नहीं।

अपने स्वयं के टेलीमेट्री के साथ स्टैंडअलोन लेनदेन के रूप में अलग योगदान, ट्रिगर और भुगतान।

4) एपीआई संदर्भ अनुबंध

4. 1 आरजीएस/ → एग्रीगेटर जेपी (योगदान और ट्रिगर)

'POST/v1/jp/contribution' - पूल योगदान के लिए लेखांकन

json
{
" :" uid-1 "," : "ब्रांड -42", " :" ग्रैंड-यूरोपीय संघ -01 "," : ""  "": " ": "" "" शर्त ": {" राशि ": 2। 00, "मुद्रा": "EUR"}, " ": {"राशि": 0। 02, "मुद्रा": "EUR"}, " : ""  ": " "
}

'POST/v1/jp/उम्मीदवार' - शर्तों की भागीदारी/सत्यापन के लिए आवेदन (वैकल्पिक)

उत्तर: 'योग्य: सही/गलत', वजन या मौका, नियम।

'POST/v1/jp/ट्रिगर' - ऑपरेशन के तथ्य को रिकॉर्ड करना

json
{
" :" uid-2 "," : "ग्रैंड-यूरोपीय संघ -01", "कारण": " " "चयनकर्ता": {"player _ id": " ": " ": " ": "": "": " ": "" ""
}

💡 नोट: कुछ मॉडलों में, ट्रिगर की शुरुआत जेपी (आंतरिक रूले) द्वारा की जाती है, और आरजीएस केवल दौर की रिपोर्ट करता है। फिर 'ट्रिगर' को कहा जाता है - और आरजीएस घटना की सदस्यता लेता है।

4. 2 जेपी → प्लेटफॉर्म (भुगतान/प्रावधान)

'POST/v1/वॉलेट/रिजर्व' - (वैकल्पिक) भविष्य के भुगतान के लिए प्रावधान

'POST/v1/वॉलेट/क्रेडिट' - खिलाड़ी क्रेडिट जीतता है

json
{
"": "uid-3", " :" ब्रांड -42 "," : " " ":" ग्रैंड-यूरोपीय संघ -01 "," राशि ": {" राशि ": 500000। 00, "मुद्रा": "EUR"}, "मेटा": {"टैक्स": "वापस ले लिया = गलत", "टियर": "भव्य"}, "idempotency_key": "jp_p_grand_r_123"
}

प्लेटफ़ॉर्म प्रतिक्रियाएँ: ठीक है	विफल ', कारण कोड (आरजी/एएमएल, वापसी सीमा, प्रतिबंध, भू-ब्लॉक) के साथ।

4. 3 प्रकाशित पूल स्थिति (मोर्चों/विजेटों के लिए)

'GET/v1/jp/पूल/{ pool _ id}' - वर्तमान आकार, बीज, टोपी, प्रतिभागियों की संख्या, ETA, आदि।

'GET/v1/jp/pools' फिल्टर के साथ ब्रांड/क्षेत्र द्वारा पूल की सूची।

5) इवेंट मॉडल (काफ्का/पल्सर) और आरेख

बुनियादी विषय:

'जेपी। योगदान। रिकॉर्ड किया गया '
'जेपी। पूल। अद्यतन '(आकार, प्रतिस्पर्धी अपडेट)
'जेपी। ट्रिगर 'ट्रिगर'

'जेपी। भुगतान। अनुरोध किया ग	श्रेय	असफलता '
'wallet। ऋण। '(सागा के लिए प्रतिबिंब)
'rg। सीमा। हिट ',' aml। अलर्ट। खोला गया '(यदि भुगतान अवरुद्ध है
'audit। कॉन्फिग। परिवर्तित '(सीमा, बीज, टोपी, वितरण)

अनुबंध: एवरो/जेसन स्कीमा + स्कीमा रजिस्ट्री, भागीदारी कुंजी 'किरायेदार _ आईडी', 'पूल _ आईडी', 'प्लेयर _ आईडी'। वर्शनिंग - पिछड़े-संगत।

6) ट्रिगर एल्गोरिदम (उच्च-स्तर)

संभाव्य (पी-स्थिर): प्रत्येक योग्य दौर के लिए हम संभावना 'पी' (पूल/स्तर के प्रकार के आधार पर) के साथ एक हिट उत्पन्न करते हैं।

रेंज (मस्ट-ड्रॉप): पूल को कैप-सम या समय सीमा तक गिरना चाहिए - रेंज [मिनट, मैक्स] में आंतरिक यादृच्छिक रखें, कैप/ईटीए प्रकाशित करें।

बीज और एन्ट्रापी प्रबंधन: सर्वर बीज + प्रति-गोल नमक; ग्राहक जैकपॉट सीटों को छोड़ ना। बीज में सभी परिवर्तन WORM ऑडिट के तहत हैं।

ईमानदारी: ट्रिगर को खिलाड़ी के विशिष्ट व्यक्तित्व (भू/लाइसेंस/योग्यता नियमों के अलावा) पर निर्भर नहीं होना चाहिए। कोई भी "व्यक्तिगत" लक्ष्यीकरण वर्जित है।

7) एसएलओ और प्रदर्शन

p95 'योगदान' <120 ms, p99 <250 ms।

p95 'trigger→credit' <500 ms (बाहरी भुगतान हॉप्स के बिना)।

"लॉस्ट/डुप्लिकेटेड पेआउट" = 0 (अनुबंध परीक्षणों द्वारा जाँच की गई)।

BI ≤ 5 मिनट के लिए इवेंट डिलीवरी।

महत्वपूर्ण रास्तों के लिए जेपी एपीआई उपलब्धता ≥ 99। 95%.

8) सुरक्षा और अनुपालन

सभी mTLS + हस्ताक्षर (HMAC/EdDSA) पर अल्पकालिक टोकन कहते हैं।

शून्य-विश्वास: नेटवर्क नीतियां/जाल, न्यूनतम विशेषाधिकार, क्षेत्र द्वारा विभाजन।

सीमा, सूत्र, बीज/एन्ट्रापी, पूल कॉन्फ़िग में परिवर्तन का WORM ऑडिट।

जीडीपीआर/डेटा रेजिडेंसी/पीसीआई: पीआईआई और लॉग - क्षेत्र में; संवेदनशील क्षेत्रों का टोकन; क्रॉस-रीडिंग पर प्रतिबंध लगाना।

आरजी/एएमएल: भुगतान पर तुल्यकालिक ब्रेक रोशनी; SAR/STR अपलोड स्वचालित हैं।

9) सुसंगतता और सागा

योगदान ('योगदान') - जेपी में फिक्स करें, 'जेपी' प्रकाशित करें। योगदान। रिकॉर्ड किया ग

ट्रिगर ('ट्रिगर') - एक दायित्व बनाता है; जेपी ने 'पेआउट' सागा लॉन्च किया।

भुगतान ('भुगतान। अनुरोध किया → बटुआ। ऋण। ठीक है ') - गाथा को समाप्त करता है; deduplication के साथ नकली - रिट्राई के साथ।

आउटबॉक्स/सीडीसी घटनाओं को प्रकाशित करने का एकमात्र तरीका है; कोई "बाईपास" लॉगर नहीं।

10) टेलीमेट्री और डैशबोर्ड

व्यवसाय:

'पूल _ size', ' _ रेट', 'avg _ _ per _ bet', 'time _ to _ drop', 'payouts _ count/sum', 'tier _ distristion'।

तकनीकी:

p50/p95/p99 по 'योगदान', 'ट्रिगर', 'पेआउट';
त्रुटि दर с типами (5xx/4xx/व्यवसाय), पुन: तूफान, कतार अंतराल;
'wallet। क्रेडिट 'विलंबता/ओके-रेट; पूल अपडेट संघर्ष।

अलर्ट:

वृद्धि 'payout। ब्रांड/क्षेत्र द्वारा '> X%,' पूल _ size '> कैप - Y% समय (कॉन्फ़िगरेशन त्रुटि),' पूल _ साइज़ 'और सामंजस्य योगदान राशि> Z पीपीएम के बीच बहाव।

11) बहु-किरायेदारी और अलगाव

सभी अनुरोधों और घटनाओं को 'किरायेदार _ आईडी/ब्रांड _ आईडी/लाइसेंस/क्षेत्र' चिह्नित किया गया है।

स्थानीय/नेटवर्क पूल विभिन्न लाइसेंसों/क्षेत्रों के तहत शारीरिक रूप से अलग (डीबी/क्लस्टर) हैं।

रो-स्तरीय सुरक्षा (आरएलएस) और बीआई स्टोरफ्रंट में मास्किंग।

प्रति ब्रांड/क्षेत्र में व्यक्तिगत कुंजी/रहस्य और योजनाबद्ध स्

12) बोनस/टूर्नामेंट के साथ एकीकरण

योगदान सीधे वेगर को नहीं बढ़ाते हैं; बोनस में योगदान - दांव से आता है, योगदान से नहीं।

टूर्नामेंट "जेपी भागीदारी" या "शीर्ष योगदान" के लिए अंक प्रदान कर सकते हैं। "स्रोत - घटनाओं 'जेपी। योगदान। रिकॉर्ड किया गया 'и' जेपी। ट्रिगर '।

अनिवार्य नियम: जैकपॉट यांत्रिकी खेल के मूल आरटीपी को नहीं बदलते हैं; अन्यथा अलग प्रमाणन की आवश्यकता

13) परीक्षण और अराजकता प्रथाओं

अनुबंध परीक्षण RGS↔JP↔koshelyok: डबल-डिलीवरी, देरी, आउट-ऑफ-ऑर्डर, रोलबैक।

लोड परीक्षण: दांव और ट्रिगर का तूफान, स्केलिंग पूल श्रमिकों।

अराजकता अभ्यास: जेपी क्षेत्र का पतन, ऑफ़ लाइन बटुआ, समय desynchronization; आउटबॉक्स और क्षरण की जाँच करें (ठहराव ट्रिगर/कोई नया योगदान नहीं)।

14) चेकलिस्ट

स्टूडियो/आरजीएस के लिए

पहचान 'योगदान' और सही 'गोल _ आईडी '/' बेट _ आईडी'।
कोई प्रकाशन "बायपासिंग" लेनदेन (केवल आउटबॉक्स/सीडीसी) नहीं।
डुप्लिकेट/दोहराए गए ट्रिगर/मुआवजे के परीक्षण।
अधिकतम शर्त/योग्यता सीमा जेपी को हस्तांतरित की जाती है।

ऑपरेटर/प्लेटफॉर्म के लिए

लेजर सत्य का स्रोत है, 'बटुआ। क्रेडिट 'deduplication के साथ।
आरजी/एएमएल स्टॉप वेतन पर संसाधित किए जाते हैं; एसएआर/एसटीआर रिपोर्ट।
p95 'trigger→credit' डैशबोर्ड, त्रुटि दर, पूल सामंजस्य।

जेपी मालिक के लिए

सूत्र/बीज/सीमा परिवर्तन का WORM ऑडिट।
रजिस्ट्री और संस्करण में घटना स्कीमा।
डीआर: आरपीओ ≤ 5 मिनट, आरटीओ ≤ 30 मिनट; नियमित अभ्यास।
आरएलएस/ब्रांड/लाइसेंस द्वारा अलगाव; प्रति क्षेत्र कुंजी/रहस्य।

15) लाल झंडे (विरोधी पैटर्न)

डेटाबेस में पूल आकार और भुगतान के मैनुअल संपादन।

पहचान की कमी - डुप्लिकेट ऋण।
आउटबॉक्स/सीडीसी → "खोया" योगदान/ट्रिगर के बिना टेलीमेट्री प्रकाशित करना।
पीआईआई और विभिन्न क्षेत्रों के मौद्रिक डेटा का मिश्रण।
जैकपॉट जो नए प्रमाणन के बिना बेस गेम के आरटीपी को प्रभावित करता है।
कोई बटुआ और पूल सामंजस्य नहीं; रिपोर्ट मुकाबला OLTP पर आधारित हैं।

जैकपॉट सिस्टम एपीआई एक स्टूडियो, प्लेटफॉर्म और ऑपरेटर के बीच एक मौद्रिक घटना अनुबंध है। इसकी नींव: पहचान और सागा, पैसे का सख्त अलगाव, स्पष्ट घटना योजनाएं, सुरक्षा और WORM ऑडिट, अवलोकन और SLO। इस डिजाइन पर, फिक्स/प्रगतिशील और नेटवर्क पूल पूर्वानुमानित रूप से, भुगतान सही रहते हैं, और नियामक और व्यापार रिपोर्टिंग पारदर्शी और विश्