Ինչպես է API-ն աշխատում Live խաղերի հետ պլատֆորմի

1) Ընդհանուր ճարտարապետությունը և բաղադրիչների դերը

Օպերատորի պլատֆորմը (Casino Platform) 'հաշիվներ, դրամապանակ, բոնուսային շարժիչ, լիմիտներ, KYC/AML, գործարքների ամսագիր։

Ռուսական խաղերի պրովայդերը (Studio/Provider) 'ստուդիաներ, դիլերներ, տեսահոլովակներ (Windows RTC/Low-Latency HLS), խաղերի խաղային սերվեր։

Ագրեգատորը (երբեմն) 'մեկ API-ը տասներորդ պրովայդերի, արժույթների/լիմիտների/իրադարձությունների միավորումը։

Հաճախորդի ճակատը 'վեբ/բջջային հաճախորդը UI-ի հետ, տեսահոլովակը, չատը, տեղական պատասխանները։

Ռուսական ծառայությունները ՝ Risk/Anti-fraud, լոգոն, վերլուծություն, հաղորդագրությունների գծեր (Kafka/RabbitMQ), ռուսական։

Տիպիկ տեղաբանություն 'հաճախորդը (JWT) ռուսական պլատֆորմ (server-to-server) ռուսական պրովայդեր է, միաժամանակ հաճախորդը ստանում է CDN/pul լրատվամիջոցների։

2) Խաղացողի և նստաշրջանի կյանքի ցիկլը

2. 1. Լոգինը և «խաղային հոսքը»

1. Խաղացողը ներկայացված է պլատֆորմի վրա։

2. Պլատֆորմը առաջացնում է Creator GameSession պրովայդերի (S2S), փոխանցում է «player _ id», «currency», «country», «bet _ limits», պատասխանատու խաղի դրոշները։

3. Պրովայդերը վերադարձնում է միանգամյա օգտագործվող game _ token և launch _ url։

4. Հաճախորդը բացում է «launch _ url» iframe/նոր տարբերակով, ավելացնելով «game _ token» (կամ ստանում է 302 վերջնական URL խաղի համար)։

S2S հարցման օրինակ

http
POST /api/v1/sessions
Content-Type: application/json
Authorization: Bearer <platform_api_key>

{
"player_id": "u-918273",  "session_id": "sess-5f3b2",  "currency": "EUR",  "country": "DE",  "lang": "de",  "bet_limits": {"min": 0. 5, "max": 2000},  "responsible_gaming": {"self_excluded": false, "deposit_limit_left": 150},  "callback_urls": {
"balance": "https://platform. example. com/wallet/balance",   "debit":  "https://platform. example. com/wallet/debit",   "credit": "https://platform. example. com/wallet/credit",   "rollback":"https://platform. example. com/wallet/rollback",   "events": "https://platform. example. com/game/events"
}
}

Պրովայդերի պատասխանը

json
{
"game_token": "gtkn_7f0...e2a",  "launch_url": "https://live. provider. com/launch/roulette",  "expires_in": 900
}

2. 2. Վավերացում առջևում

Խաղը բեռնվում է, առաջնորդում է «game _ token» -ը իր բեկենդով։

Տեղադրվում է Socket-ը խաղային խաղի համար 2019/իրադարձությունների համար։
Տեսահոլովակը գնում է Windows RTC-ով (ցածր ուշացում 0։ 5-2 s) կամ LL-HMS (2-5 s)։

3) Փողն ու տոկոսադրույքները 'Wallet API և impotenty

3. 1. Հավասարակշռություն և դեբեթ/վարկ

Պրովայդերը չի պահպանում խաղացողի «գումարը», այն առաջացնում է Platform Wallet API-ը

`GET /wallet/balance? player _ id '- ն առկա հասանելի է։

«POST/wallet/debit» -ը պետք է գրվի։
«POST/wallet/credit» - ը պետք է դադարեցնի հաղթանակը/2019։
«POST/wallet/rollback» -ը բացատրում է գործարքների արձագանքը պայմանագրերի վերացման ժամանակ։

Կարևոր է 'բոլոր դրամական վիրահատությունները idempotention _ id' id _ id "։ Նույն հարցման խոհարարը չի փոխում արդյունքը։

Դեբետի օրինակը (տոկոսադրույքը)

http
POST /wallet/debit
Idempotency-Key: trx-7a2df-001
Content-Type: application/json

{
"player_id": "u-918273",  "round_id": "r-2025-10-18-12:30:15Z-001",  "transaction_id": "trx-7a2df-001",  "amount": 25. 00,  "currency": "EUR",  "bet_type": "roulette_straight",  "meta": {"table_id":"ru-11", "selection":"17", "odds":35}
}

3. 2. Թայմինգները և տոկոսադրույքի կարգավիճակները

WINDOW_OPEN → WINDOW_CLOSING → WINDOW_CLOSED. «CSO _ CLOSED» -ից հետո պրովայդերը արգելում է նոր բանավեճերը։

Ուշ տոկոսադրույքները շեղվում են «LATE _ BET» կոդով։

Կապի խզման ժամանակ հաճախորդը կարող է կրկին ուղարկել տոկոսադրույքը, սերվերը պետք է կարողանա տարբերակել կրկնօրինակը Idempotency-Key-ում։

Գործարքների կարգավիճակները ՝ «PENDING», «SETTLED», «ROLED _ BACK», «REJECTED»։

4) Իրադարձություններ. Մոդել և հաջորդականություն

4. 1. Իրադարձությունների սխեմա Express Socket

`round. started '2019-ը գալիս է «round _ id», թայմերը։

`bet. accepted/rejected "-ը հաստատվում է յուրաքանչյուր տոկոսադրույքով։

`round. closed 'ռուսական տոկոսադրույքները այլևս չեն ընդունվում։
`round. ռեզոնանսային արդյունք (ռուլետկա/քարտեր/ոսկորներ)։
`payout. created '- ը խաղացողի հաղթելու գումարը։
`round. settled 't վերջնական կարգավիճակ, վերահսկողական գումար։

Արդյունքի իրադարձության օրինակը

json
{
"type": "round. result",  "round_id": "r-2025-10-18-12:30:15Z-001",  "table_id": "ru-11",  "payload": {
"roulette": {"number":17, "color":"black"},   "hash": "sha256:8a7b...d1c",   "video_ts": "2025-10-18T12:30:23. 450Z"
}
}

4. 2. Համաձայնություն և վերահսկողական գումարներ

Յուրաքանչյուր իրադարձություն մատակարարվում է «seq» և «signature» (mTSA + հարցման մարմնի ստորագրությունը)։

Reconciliation pro 'payout _ www.ksum "- բոլոր վարկերի գումարը պետք է համընկնի։

5) Տեսագրությունն ու ուշացումը

Windows RTC-ը «կենդանի ձեռքը» (blackjek/bukara/ruletka) - խիստ բյուջեթը հետաձգման համար <2 c մինչև հաճախորդը։

LL-HMS/DASH հանդիսատեսի/մասշտաբի համար, թույլ է տալիս 2-5 c։

Ժամանակի համաժամացումը 'NTP/chrony, payload-ում' «video _ ts» ռելպեների և վեճերի համար։

Ֆոլբեքը 'Windows RTC-ի դեգրադացիայի ժամանակ բացատրում է LL-HMS-ի շարժումը ուշ կոդերի արգելափակումով։

6) Սխալներ, ակնարկներ, թայմաուտներ

Ընդհանուր կանոնները

Բոլոր S2S մարտահրավերները 800-1500 մզ թայմաուտով, էքսպոնենցիալ դադարով և Jitter-ով, բայց առանց փողի կրկնապատկման (idempotent)։

Դրամապանակի սխալների իրականացումը

`INSUFFICIENT_FUNDS`, `LIMIT_EXCEEDED`, `ACCOUNT_LOCKED`, `DUPLICATE_TRANSACTION`, `LATE_BET`, `CURRENCY_MISMATCH`.

Սխալի ձևաչափը

json
{
"error": "INSUFFICIENT_FUNDS",  "message": "Balance 18. 00 < required 25. 00",  "transaction_id": "trx-7a2df-001"
}

7) Բոնուսներ, ֆրիզպիններ, ապահովագրություն

"Դրամական" դրամապանակի հետ զուգահեռ կարող է լինել բոնուսային հավասարակշռություն 'payload-ում նշված է "source: CASH	BONUS`.
Live-խաղերի համար ապահովագրության/sid-bet-ը (օրինակ, blackjek) անհատական գործարքներ են սեփական սահմանափակումներով և գործակիցներով։
Կլորացման կանոնները 'բանկային (half-to-even) կամ հօգուտ խաղացողի/օպերատորի, պետք է գրանցվեն կոդավորման ճեպում։

8) Պատասխանատու խաղ և սահմանափակումներ

Նստաշրջանի դրոշները ՝ «cooldown _ until», «loss _ limit _ left», «time _ limit _ left»։

Պրովայդերը յուրաքանչյուր բանավեճի առջև կարող է պահանջել «validate _ limits»։
Պլատֆորմը կարող է նախաձեռնել force _ close _ session: Խաղացողը բացառված է/գերազանցեց ռուսական պրովայդերը փակում է պատուհանը և դարձնում է չբացահայտված տոկոսադրույքների վրա։

9) Անվտանգություն և բաղադրիչներ

MTSA-ի համար S2S, HSTS-ը, խիստ IP-allowlist-ը։

JWT/JWS-ը կարճ TTL-ով առջևի հոսանքների, audience/issuer ստուգման համար։

Webhook's պրովայդերի ստորագրությունը (HMAC-SHA256 մարմնի վրա)։
Դիլերների գործողությունների լոգները, շրջադարձերը, անփոփոխ աուդիտը (WORM պահեստ)։
Անձնական տվյալների պահպանումը PII-ի նվազեցումն է, «player _ id» -ը, իրավասության պահպանման ժամանակը (GDPR և անալոգները)։
Գեո-արգելափակումը և արգելքները Cream GameSession-ի մակարդակում։

10) Reconciliation և ֆինանսներ

10. 1. Ժամացույցի/ամենօրյա զեկույցները

Պրովայդերը զեկույց է տալիս «round _ id total _ bets, total _ enss, fees»։ Պլատֆորմը կրճատում է

Բանավեճի գումարը = Master.ru, Վարկերի գումարը = Windows-ը, Delta = GGR (հաշվի առնելով բոնուսները/ջեքպոտներ/108)։

Զեկույցի ձևաչափը

json
{
"date": "2025-10-18",  "currency": "EUR",  "tables": [{
"table_id": "ru-11",   "rounds": 1260,   "total_bets": "45230. 00",   "total_payouts": "43012. 50",   "jackpot_contrib": "302. 00",   "provider_fee": "2. 5%"
}]
}

10. 2. Rollback սցենարներ

Տեսահոլովակի/dround-ի ձախողումը։ cancelled: պրովայդեր սաղավարտը «rollback» է բոլոր փուլերում։

Բանավեճի կրկնակի մշակումը, որը բռնված է www.DUPLICATE _ TRANSACTION "և 200 OK նախկին արդյունքով։

11) Չաթ, մոդերացիա և UI իրադարձություններ

Չաթի իրադարձությունները գնում են առանձին ջրանցքի միջոցով (No Socket 242), որոնք ունեն ֆիլտրեր stop-բառով։

Գովազդի իրականացումը (close bets, www.ner list) միայն պրովայդերի վստահելի աղբյուրից է, ստորագրվել/թայմստամպացված։

12) Փորձարկում և հավաստագրում

Sandbox պրովայդերը 'ֆիքսված արդյունքներ, հնարավորություն ստիպել' round։ result`.

Windows QA: Թեստային շարժիչ 'կտրված պատուհաններով (5-8 c) և արագացված ֆլոուի հետ։

Իսպանիան '5-10 նոդեմբերի իմիտացիա միաժամանակ խաղացողների, վայրկյանում (TPS) պլանային թիվ 1։ 5.

Մրցույթի սերտիֆիկացումը 'կուռքերի, արժույթների, կլորացման, անջատումների վերամշակման, սահմանների հակամարմիններ և www.f-www.lusion։

13) Metriki և SLO

Նրանք ՝ Socket round-trip-ը, ժամանակի համաժամացման սխալը, drop-rate Express RTC-ը։

Продукт: bet acceptance rate, late-bet rate, dispute rate, chargeback rate, session duration, retention, ARPU/LTV.

SLO օրինակներ

99. 5% `debit` ≤ 1. 2 s, 99։ 9% առաքումը 'round. Resport '35300 ms ամրագրումից հետո, տեսահոլովակը թիվ 2։ 5-ը 95p System RTC-ի համար։

14) Լոկոտիվալյուտան, հարկերը, տեղայնացումը

Փոխակերպումը պրովայդերից դուրս է, խաղը աշխատում է խիստ ռուսական նստաշրջանում։

Հարկերը/պահպանումը պլատֆորմի կողմում '"credit" (դաշտը' withholding ")։
Տեղայնացումը '«lang», թվերի/արժույթի ձևաչափ, ժամացույցի գոտի թայմերի և զեկույցների համար։

15) Այլընտրանքային տարբերակներ

1. System-to-Provider: Առավելագույն վերահսկումը և ֆիչը, բայց առանձին պայմանագրեր/հավաստագրեր։

2. Ագրեգատորի միջոցով 'պրովայդերների արագ ծածկումը, միավորված սխեմաները, երբեմն ավելի քիչ ճկունություն։

3. Հիբրիդ 'առաջին սեղանները ուղղակիորեն, մնացածը ագրեգատորի միջոցով։

16) Մինի-ճշգրտումը (ընդհանուր)

16. 1. Socket-ը ներառված է (հաճախորդից մինչև պրովայդեր)

json
{ "type":"bet. place", "bet":{
"amount": 25, "selection":"17", "table_id":"ru-11"
}, "idempotency_key":"c3a2-...-001" }

16. 2. Express Socket-ը գալիս է (պրովայդերից հաճախորդին)

json
{ "type":"bet. accepted", "bet_id":"b-8821", "seq":12031 }
{ "type":"round. closed", "round_id":"r-...001", "seq":12050 }
{ "type":"round. result", "result":{"number":17,"color":"black"}, "seq":12070 }
{ "type":"payout. created", "amount":875, "currency":"EUR", "seq":12075 }

16. 3. Wallet S2S (պլատֆորմը ռուսական պրովայդեր)

«POST/wallet/debit» (idempotent)

«POST/wallet/credit» (idempotent)
«POST/wallet/rollback» (idempotent)
HMAC ստորագրությունը, «Timestamp», «Nonce», պաշտպանություն խոհարարներից (TTL 3560 c)։

17) Ներկային և ինչպես փակել դրանք։

Խաղացողի միավորման բացը 'դրույքաչափը ուղարկված է, հաստատումը չկա նույն «Idempotency-Key» -ի հետ։ սերվերը կպատասխանի նախկին կարգավիճակին։

Դիլերի/ջրհորների փոփոխությունը փուլում 'ավտոմատ վերացում և ամբողջական «rollback»։

Արժույթի անհամապատասխանությունը '"CURRENCY _ MISMATCH' + իրադարձությունների ամսագիր; խաղը արգելափակված է մինչև նստաշրջանը։
Խաղի պահին Corf-intlusion-ը 'վերացված «force _ close _ session», անլար։
Տեսահոլովակի որակի փոփոխությունը 'միայն հաճախորդը, առանց ազդելու թայմերի/տոկոսադրույքների վրա։
Re-handshaik Live Socket: Առանց կորցնելու կարգը 'իրադարձությունների հերթը' «seq» -ի հետ, բաց թողած «մրցավազքը»։

18) Չեկի թուղթ

Անվտանգություն

mTSA + pinning no, IP-allowlist։
Բոլոր webhook «-ի ստորագրությունը և» Timestamp '/« Nonce »ստուգումը։
Mini-PII: միայն «player _ id» (թունավորված)։

Վստահություն

Բոլոր դրամական գործարքների համադրելիությունը։
Շրջադարձային և անփոփոխ աուդիտ։
Avto-folbek MedRTC 35LL-HMS։

Ապրանք

Limits/պատասխանատու խաղը օգտագործվում է իրական ժամանակում։
National-ը տոկոսադրույքի պահին։
Dashbords SLO + alerts 24/7։

API-ն ցածր աջակցող հոսանքի, իրադարձական անվադողերի և համակցված դրամապանակի կապն է, որը կոշտ է հաղորդագրությունների, թայմինգների և անվտանգության համար։ Հաջողակ կոմպոզիցիան հիմնված է 'արագ կյանքի ցիկլը և փուլերը, որոնք ստուգվում են խորհրդատվության (reconciliation), տվյալների պաշտպանության և պատասխանային խաղի սահմանաչափերի վրա, և վերածում է «գեղեցիկ հեռարձակում» հուսալի, հավաստագրված ֆինանսական ապրանքի։