स्टूडियो और प्लेटफार्मों के बीच एपीआई एकीकरण कैसे काम करता है

प्लेटफ़ॉर्म/एग्रीगेटर के साथ स्टूडियो (गेम प्रदाता) का एकीकरण सत्र, बटुआ, स्पिन परिणाम और घटना टेलीमेट्री के आसपास तुल्यकालिक और अतुल्यकालिक कॉल की एक श्रृंखला है। नीचे डेवलपर्स और अनुपालन के लिए दर्द के बिना सब कुछ कैसे जुड़ ता है, इसका एक संक्षिप्त लेकिन व्यावहा

1) आपके हाथ की हथेली में वास्तुकला

अभिनेता:

स्टूडियो आरजीएस (रिमोट गेम सर्वर) - गेम लॉजिक, आरएनजी, बोनस, जैकपॉट।
प्लेटफ़ॉर्म/एग्रीगेटर - रूटिंग, बिलिंग, प्रोमो, अनुपालन।
ऑपरेटर - प्लेयर का बटुआ, केवाईसी/आरजी, शोकेस।
क्लाइंट - वेब/मोबाइल गेम कंटेनर (iframe/webview/देशी)।

मुख्य बसें:

एपीआई सिंक करें: सत्र, बटुआ, परिणाम।
Async/Event Bus: स्पिन इवेंट्स, बोनस, जैकपॉट, RG, तकनीकी त्रुटियां।
मेटाडेटा/कैटलॉग: गेम, मार्केट बिल्ड, आरटीपी प्रोफाइल, लोकेल।

2) प्रोटोकॉल और बुनियादी समाधान

परिवहन: HTTPS/JSON (कभी-कभी इवेंट बस/वॉलेट के लिए gRPC)।

संस्करण: 'स्वीकार करें: अनुप्रयोग/vnd। rgs। v1 + json 'या '/v1/...'; संगतता क्षरण - केवल नए संस्करणों के माध्यम से।

पहचान: 'गेम _ आईडी', 'बिल्ड _ हैश', 'ऑपरेटर _ आईडी', 'सत्र _ आईडी', 'राउंड _ आईडी', 'स्पिन _ आईडी'।

समय: कड़ाई से यूटीसी, ISO-8601 मिलीसेकंड के साथ।

मुद्राएँ: ISO-4217 + सटीकता (छोटी इकाइयाँ)। एफएक्स ऑपरेटर/एग्रीगेटर पक्ष।

3) प्रमाणीकरण और प्राधिकरण

सर्वर-टू-सर्वर: OAuth2 क्लाइंट क्रेडेंशियल्स или HMAC- подпись ('X-Signature: HMAC_SHA256 (पेलोड, shared_key)')।

खिलाड़ी सत्र: अल्पकालिक JWT (संकेत मंच) c 'उप', 'geo', 'rg _ flags', 'exp', 'aud = स्टूडियो'।

अभिगम सूची: आईपी उत्पादन लूप के लिए + एमटीएलएस की अनुमति देता है।

4) बटुआ मॉडल: डेबिट/क्रेडिट बनाम स्थानांतरण

ए) डेबिट/क्रेडिट (ऑन-द-फ्लाई):

1. प्लेटफ़ॉर्म आरजीएस को कहता है: 'स्पिनरिक्वेस्ट (हिस्सेदारी)' → आरजीएस परिणाम की गणना करता है → रिटर्न 'जीत'।

2. समानांतर में, प्लेटफ़ॉर्म ऑपरेटर के स्थान पर 'डेबिट (हिस्सेदारी)' और 'क्रेडिट (जीत)' बनाता है।

पेशेवरों: सरल बहीखाता। विपक्ष: अधिक नेटवर्क कॉल, पहचान के लिए सख्त आवश्यकताएं।

बी) स्थानांतरण (सत्र शेष):

1. सत्र की शुरुआत में, मंच आरजीएस पर 'ट्रांसफर इन (राशि)' करता है।

2. स्पिन के दौरान, आरजीएस खुद सत्र को संतुलित करता है; पूरा होने पर - 'ट्रांसफर आउट (शेष)'।

पेशेवरों: कम बटुए चैट। विपक्ष: "आरजीएस की तरफ से पैसा", अतिरिक्त जोखिम और सामंजस्य के लिए लेखांकन।

सिफारिशें:

स्लॉट के लिए, आदर्श कुंजी के साथ डेबिट/क्रेडिट अधिक बार उपयोग किया जाता है।

मुफ्त स्पिन और टूर्नामेंट पर अलग-अलग शर्त प्रकार के स्पिन _ टाइप = मुफ्त होना सुविधाजनक है	प्रोमो '।

5) पहचान और निरंतरता

प्रत्येक पैसे के चरण में एक अद्वितीय 'idempotency _ key' होना चाहिए (उदाहरण के लिए, 'गोल _ id' या 'स्पिन _ id')।

डुप्लिकेट ('HTTP 409/425') एक ही परिणाम लौटाता है, न कि "पहले से निष्पादित त्रुटि"।

वास्तव में-एक बार हासिल करना मुश्किल है, इसलिए हम कम से कम एक बार + पहचान बनाते हैं।

पहचान को बढ़ाया जाता है: 'डेबिट', 'क्रेडिट', 'जैकपॉट _ कंट्रीब्यूशन', 'बोनस _ अवार्ड'।

6) मुख्य क्वेरी योजनाएं (संक्षिप्त)

6. 1. सत्र का प्रारंभ

json
POST/rgs/v1/सत्र
{
"": "s-"... "," ":" op-... "," : ":" p- "...," "::" g-BookOf... "," : ":" "sha256:...", jwt ":" eyJhbGci "..." EO ":" DE "," E": "{" स्वयं _ बहिष्कृत ": गलत," : 60}
}

6. 2. स्पिन (डेबिट/क्रेडिट)

json
POST/rgs/v1/spins
{
"spin_id": "स्पिन-...", "round_id": "rnd-...", "session_id": "s-"..., "हिस्सेदारी": {"राशि": 1। 00, "मुद्रा": "EUR"}, "spin_type": "नकद", "idempotency_key": "स्पिन-"...
}

उत्तर:

json
{
"spin_id": "स्पिन-...", "परिणाम": {
"जीत": {"राशि": 3। 40, "मुद्रा": "EUR"}, "सुविधाएँ": [{"प्रकार ": "बोनस _ ट्रिगर ", "नाम":" फ्रीस्पिन्स"," गिनती": 10}], "प्रतीक": "अपारदर्शी-या-छोड़ा"
} ", rgs_txns": [
{"प्रकार ": "जैकपॉट _ कंट्रीब्यूशन"," राशि": 0। 01}
] ", telemetry_ref": "evt-"..
}

6. 3. घटना बस

json
POST/rgs/v1/events/batch
{
"घटनाएं": [
{
"प्रकार ": "स्पिन _ समाप्त", "ts ":" 2025-10-20T11: 22:33। 123Z," "spin_id":"spin-...," "round_id":"rnd-...," "हिस्सेदारी": 1। 00, "जीत": 3। 40, "मुद्रा": "ईयूआर", "game_id":"g-...,""build_hash":"sha256:...," "player_id":"p-...,""operator_id":"op-...," "spin_type":"cash" "
}
]
}

7) वर्शनिंग बिल्ड और मार्केट बिल्ड

'build _ hash' (SHA-256) - प्रत्येक घटना पर आवश्यक।

ग्लोबल बनाम मार्केट बिल्ड: भाषा, चेतावनी, दर सीमा, आरटीपी प्रोफाइल।

प्लेटफ़ॉर्म मान्य करता है: "वर्तमान में खेला जा रहा एक बिल्ड है जो किसी दिए गए देश के प्रमाण पत्र से मेल खा

मैट्रिक्स: 'गेम _ आईडी × देश × rtp_profile × build_hash'।

8) आरएनजी, गणित और रिप्ले

आरएनजी आरजीएस पर रहता है; व्यापार तर्क मक्खी पर मौके नहीं बदलता है।

फोरेंसिक के लिए: 'बीज/नॉन' प्रति राउंड/स्पिन + मैकेनिक संस्करण।

रीप्ले: 'स्पिन _ आईडी '/' सीड' द्वारा, आरजीएस परिणाम को पुन: पेश करता है और एक ऑडिट ट्रेल देता है।

9) जिम्मेदार गेमिंग (आरजी) और अनुपालन हुक

समय/सीमाओं के हुक: 'सत्र _ time _ ms', "रिमाइंडर", टाइमआउट; इवेंट बस में 'rg _ event'।

स्व-बहिष्करण/ब्लॉक: ध्वज के साथ - तत्काल '403 RG_BLOCKED'।

UI अपरिवर्तनीय: मंच जाँच करता है कि ग्राहक बाजार निर्माण से चेतावनी/आयु टैग दिखाता है।

10) कीड़े, रिट्रेज़और एसएलए

कोड: '400' (सत्यापन), '401/403' (प्रमाणीकरण/आरजी), '409' (पहचान संघर्ष), '422' (व्यावसायिक त्रुटि), '429' (दर सीमा), '5xx' (अस्थायी)।

रिट्रे पॉलिसी: घातीय, रिसीवर पर एक अज्ञात कुंजी और कमी के साथ।

SLA ≥99 API उपलब्धता। 9%, 'स्पिन' के लिए p95 विलंबता ≤200 -300 ms (क्षेत्रीय), इवेंट बस - निकट-वास्तविक समय <60 s।

11) अवलोकन और लेखा परीक्षा

लॉग: सहसंबंध 'ट्रेस _ आईडी' के साथ अनकट सर्वर लॉग।

मेट्रिक्स: p95/p99 विलंबता, विधियों द्वारा त्रुटि दर, आरटीपी/बोनस आवृत्तियों का विचलन, "लोचदार स्पिन" का अनुपात।

अलर्ट: एसएलए द्वारा, गणित विसंगतियों द्वारा, बटुए की विफलताओं में वृद्धि से।

ऑडिट: सट्टेबाजी/परिणाम घटनाओं के लिए WORM भंडारण; मांग पर निर्यात।

12) सुरक्षा

mTLS + TLS 1। 2 +, HSTS, क्लाइंट लोडर पर सख्त CORS।

मुख्य रोटेशन, छोटा टीटीएल टोकन, जेटीआई/नॉन चेक।

क्लाइंट के लिए एंटी-टैम्पर: एसेट सिग्नेचर, इंटीग्रिटी चेक, डिबगर प्रोटेक्शन।
रहस्य - केवल गुप्त प्रबंधक में; नहीं "खेल के कॉन्फिग में कुंजी।"

13) परीक्षण वातावरण और प्रमाणन

सैंडबॉक्स: काल्पनिक पर्स, नियतात्मक आरएनजी (निश्चित बीज), आरजी परिदृश्यों की ऑटो-विफलता।

मंचन: वास्तविक धन के बिना प्रोड-इन्फ्रा की एक प्रति।

प्रयोगशालाओं के लिए पैकेज: GDD/गणित, RNG डोजियर, लॉग आरेख, दोहराने योग्य बिल्ड और हैश।

14) एपीआई में प्रोमोस और जैकपॉट

फ्री स्पिन: पैकेट ट्रांसफर: 'grant _ free _ spins (काउंट, bet_size, rtp_profile?)'; घटनाओं को आरजीएस में खर्च किया जाता है और लॉग किया जाता है।

टूर्नामेंट: इवेंट बस में 'स्पिन _ टाइप = टूर्नामेंट' + व्यक्तिगत समुच्चय।

जैकपॉट: अलग लेनदेन के रूप में 'जैकपॉट _ कंट्रीब्यूशन' और 'जैकपॉट _ विन'; पहचान और "हस्ताक्षरित" घटनाओं के माध्यम से स्थिरता।

15) रिपोर्टिंग और बिलिंग

: 'स्पिन _ टोटल', 'पात्र _ स्पिन्स', 'टर्नओवर', 'जीजीआर', 'नेटविन', 'जैकपॉट _ ', 'बोनस _ कॉस्ट', 'रॉयल्टी _ काउंट'।

प्रति-स्पिन/टर्नओवर-शुल्क: 'पात्र _ स्पिन्स' या 'the हिस्सेदारी × दर' द्वारा खाता।

रेव-शेयर: 'झरने' के बाद 'नेटविन' से; एफएक्स/अपवादों के लिए त्रैमासिक सच्चाई।

16) विशिष्ट अनुक्रम (शब्द चार्ट)

स्पिन (डेबिट/क्रेडिट):

क्लाइंट प्लेटफ़ॉर्म: स्टार्टराउंड प्लेटफ़ॉर्म आरजीएस: स्पिन आरजीएस प्लेटफ़ॉर्म: परिणाम प्लेटफ़ॉर्म वॉलेट: क्रेडिट प्लेटफ़ॉर्म क्लाइंटरबस: ।

मुफ्त स्पिन:

प्लेटफ़ॉर्म → RGS: GoutherFreeSpins → क्लाइंट: Start → RGS: प्रत्येक → EventBus: spin_finished (spin_type=free)।

17) परिवर्तन-प्रबंधन और इंटरऑपरेबिलिटी

कॉन्ट्रैक्ट-फर्स्ट: OpenAPI/Protobuf स्कीमा का एकल स्रोत है।

SemVer: केवल खेतों को जोड़ें; मिटाएँ/परिवर्धित करें - इन/v2।

केवल प्रमाणित प्रोफाइल के माध्यम से फ्लैग्स-सक्षम विकल्प (बोनस खरीदें/Ante)।

अस्वीकृति: निष्क्रिय क्षेत्रों में → अनुग्रह अवधि → बंद की घोषणा करें।

18) चेकलिस्ट

स्टूडियो → प्लेटफॉर्म

OpenAPI/gRPC चश्मा और नमूना पेलोड।
IDempotency 'स्पिन/डेबिट/क्रेडिट/जैकपॉट'।
'build _ hash' और बाजार रजिस्ट्री बनाता है।
आरएनजी प्रतिकृतियाँ और ऑडिट लॉग।
आरजी हुक और त्रुटियों '403 RG_BLOCKED'।
फिक्स-सीड, टेस्ट वॉलेट और ऑटो स्क्रिप्ट के साथ सैंडबॉक्स।

प्लेटफ़ॉर्म → स्टूडियो

छोटे TTL, मिश्रधातु IP, mTLS के साथ JWT हस्ताक्षर।
बाजार के मान्यता प्राप्त प्रमाण पत्र।
इवेंट बस और डैशबोर्ड (विलंबता/त्रुटि/आरटीपी बहाव)।
ईमानदार प्रतिक्रिया '429-पुनरावृत्ति-आफ्टर' के साथ कोटा और दर-सीमा।
SLAs/घटनाएँ/लिंक 24 × 7।

19) 30-60-90 प्रक्षेपण योजना

0-30 दिन

एपीआई अनुबंध और घटना योजनाओं पर सहमत हों, एक बटुआ मॉडल चुनें।

सैंडबॉक्स उठाएं: फिक्स्ड-सीड आरएनजी, टेस्ट वॉलेट, आइडेम्पोटेंसी के ऑटोटेस्ट।

रजिस्ट्री 'build _ hash' और प्राथमिक मैट्रिक्स बाजार बनाता है।

31-60 दिन

बटुआ और स्पिन एकीकरण; घटना बस और डैशबोर्ड सक्षम करें।

लोड परीक्षण (p95/p99), रेट्राई/पहचान, नेटवर्क अराजकता परिदृश्य।
अनुपालन: आरजी-हुक, स्थान, आयु-लेबल; प्रयोगशाला को पैकेज।

61-90 दिन

1-2 ऑपरेटरों के लिए पायलट, प्रोमो के लिए ए/बी (मुफ्त स्पिन/टूर्नामेंट)।

ट्रू-अप/रिपोर्टिंग दर्ज करना, RTP बहाव अलर्ट/बोनस-freq।

v2 सुधार तैयार करना: बैच इवेंट्स, जीआरपीसी फॉर वॉलेट, जियो-रूटिंग।

20) शॉर्ट एफएक्यू

आरटीपी/संस्करण कहाँ जांचा जाता है? मंच पर: 'build _ hash' ↔ सर्टिफिकेट ↔ देश।

क्या RTP को गतिशील रूप से बदला जा सकता है? नहीं, यह नहीं है। केवल पूर्व-प्रमाणित प्रोफाइल और केवल स्विचिंग बाजार निर्माण।

"डबल डेबिट" को कैसे हल करें? पहचान कुंजी + भंडारण लेनदेन स्थिति; फिर से-परिणाम लौटाता है।

क्या मुझे जीआरपीसी की आवश्यकता है? उच्च मात्रा में बटुआ/घटनाओं के लिए उपयोगी; REST मेटाडेटा/व्यवस्थापक पैनल के लिए बना हुआ है।

स्थिर एकीकरण अनुबंध + पहचान + अवलोकन है। पारदर्शी घटना योजनाएं, बिल्ड/मार्केट कंट्रोल, आरजी हुक और संस्करण अनुशासन शुरू में 90% जोखिम दूर करते हैं। इसके अलावा - प्रोमो और रिपोर्टिंग का स्वचालन, हार्ड एसएलए और "ब्रेकिंग" परिवर्तन के बिना एपीआई का सावधानीपूर्वक विकास।