Чӣ гуна API барои пайваст кардани бозиҳои зинда ба платформа кор мекунад

1) Нақшҳои меъморӣ ва ҷузъҳои умумӣ

Платформаи оператор (Платформаи Казино): ҳисобҳо, ҳамён, муҳаррики бонус, маҳдудиятҳо, KYC/AML, сабти транзаксия.

Провайдери бозии зинда (Studio/Provider): студияҳо, дилерҳо, ҷараёнҳои видео (WebRTC/Low-Latency HLS), даврҳои серверҳои бозӣ.

Агрегатор (баъзан): як API барои даҳҳо провайдерҳо, муттаҳидсозии асъор/маҳдудиятҳо/рӯйдодҳо.

Пешсафи муштарӣ: муштарии веб/мобилӣ бо гарави UI, плеери видео, чат, дархостҳои маҳаллӣ.

Хизматрасониҳои ёрирасон: Хавф/зидди қаллобӣ, воридшавӣ, таҳлил, навбати паёмҳо (Kafka/RabbitMQ), мониторинг.

Топологияи маъмулӣ: → муштарӣ (JWT) → § платформаи (сервер-ба-сервер) → провайдер, дар баробари ин, муштарӣ аз ҳавзи сервери CDN/media ҷараёни видео мегирад.

2) Давраи зиндагӣ ва ҷаласаҳои бозингар

2. 1. Воридшавӣ ва "аломати бозӣ"

1. Плеер ба платформа ворид мешавад.

2. Платформа аз провайдер (S2S) Created-Game-ро даъват мекунад, 'player _ id', 'асъор', 'кишвар', 'bet _ limits', парчамҳои бозии масъулро интиқол медиҳад.

3. Провайдер як маротиба game_token ва launch_url бармегардонад.

4. Мизоҷ 'launch _ url' in iframe/ҷадвали навро мекушояд ва 'game _ token' -ро илова мекунад (ё 302 ба URL ниҳоии бозӣ меорад).

Намунаи дархости S2S:

http
POST/api/v1/ҷаласаҳо
Намуди мундариҷа: барнома/json
Авторизатсия: доранда <platform_api_key>

{
"player_id": "u-918273", "session_id": "sess-5f3b2", "асъор": "EUR", "кишвар": "DE", "lang": "de", "bet_limits": {"min": 0. 5, "max": 2000}, "responsible_gaming": {"худ _ истисно": дурӯғ ", deposit_limit_left": 150} ", callback_urls": {
"тавозун": "https ://платформа. намуна. com/ҳамён/тавозун" ", дебетӣ": "https ://platform. намуна. com/ҳамён/дебет" ", кредит": "https ://platform. намуна. com/ҳамён/қарз" ", бозгашт ": "https ://платформа. намуна. com/ҳамён/бозгашт" ", ҳодисаҳо": "https ://платформа. намуна. com/бозӣ/рӯйдодҳо"
}
}

Ҷавоби провайдер:

json
{
"game_token": "gtkn_7f0...e2a," "launch_url": "https ://live. провайдер. com/launch/roulette," "expires_in": 900
}

2. 2. Аутентификатсия дар пеш

Бозӣ бор мекунад, 'game _ token' -ро тавассути пуштибони худ тасдиқ мекунад.

Websocket ба сервери бозӣ барои гарав/рӯйдодҳо насб карда шудааст.

Ҷараёни видео тавассути Web-RTC мегузарад (таъхири кам 0). 5-2 с) ё LL-HLS (2-5 с).

3) Пул ва гарав: Ҳамён API ва аблаҳӣ

3. 1. Тавозун ва дебет/қарз

Провайдер "пул" -и плеерро нигоҳ намедорад - онро Platform Wallet API меноманд:

'Гир/ҳамён/тавозун? player_id' → ҷорӣ дастрас аст.
'POST/ҳамён/дебет' → аз ҳисоб хориҷ кунед.
'POST/ҳамён/қарз' → бурдҳо/баргардонидани қарзҳо.
'POST/ҳамён/бозгашт' → бозгардонидани муомилот ҳангоми бекор кардани давр.

Муҳим: ҳамаи амалиётҳои пулӣ 'transaction _ id '/' round _ id' мебошанд. Такрори ҳамон як дархост натиҷаро тағир намедиҳад.

Намунаи дебет (меъёри):

http
POST/ҳамён/дебет
Idempotency-Key: trx-7a2df-001
Намуди мундариҷа: барнома/json

{
"player_id": "u-918273", "round_id": "r-2025-10-18-12:30:15Z-001," "transaction_id": "trx-7a2df-001", "маблағ": 25. 00, "асъор": "EUR", "bet_type":" roulette_straight, "мета": {"table _ id": "ru-11", "selection": "17", "ovds": 35}
}

3. 2. Вақт ва статуси Бет

WINDOW_OPEN → WINDOW_CLOSING → WINDOW_CLOSED. Пас аз 'WINDOW _ CLOSED', провайдер дебетҳои навро манъ мекунад.

Дархостҳои дер бо рамзи 'LATE _ BET' рад карда мешаванд.

Агар пайвастшавӣ вайрон шуда бошад, муштарӣ метавонад бетро дубора барқарор кунад - сервер бояд нусхаро аз ҷониби Idempotency-Key фарқ кунад.

Ҳолати муомилот: 'Интизорӣ', 'SOLID', 'ROLLED _ BACK', 'РАД'.

4) Чорабиниҳои мудаввар: Модел ва фармоиш

4. 1. Схемаи чорабинии Websocket

'рунд. оғоз '→ меояд' round _ id ', вақтсанҷи гарав.

'бет. қабулшуда/радшуда '→ тасдиқи ҳар як дархост.

'рунд. пӯшида '→ гаравҳо дигар қабул карда намешаванд.

'рунд. натиҷа '→ натиҷа (бахши roulette/card/устухон).

'пардохт. офаридааст '→ маблағи бурдшуда аз ҷониби бозингар.

'рунд. ҳал карда шуд '§ ҳолати ниҳоӣ, checksum.

Намунаи ҳодисаи натиҷа:

json
{
"намуди": "давр. натиҷа ", round_id":" r-2025-10-18-12:30:15Z-001, "" table_id": "ru-11", "борбардорӣ": {
"roulette": {"рақам": 17, "ранг ":" сиёҳ"}, "ҳаш": "sha256: 8a7b... d1c", "video_ts": "2025-10-18T12:30:23. 450Z"
}
}

4. 2. Мувофиқат ва санҷишҳо

Ҳар як чорабинӣ бо 'seq' ва 'signature' таъмин карда мешавад (имзои MTLS + мақомоти дархост).

Барои муқоиса, 'payout _ checksum' муайян карда шудааст - маблағи ҳамаи қарзҳои 'round _ id' бояд муттаҳид карда шавад.

5) Ҷараёни видео ва таъхир

WebRTC барои букмекерии дасти зинда (blackjack/baccarat/roulette) - буҷаи қатъии таъхири <2 s ба муштарӣ.

LL-HLS/DASH барои тамошобинон/миқёс, имкон медиҳад 2-5 c.

Ҳамоҳангсозии вақт: NTP/хроника, дар сарборӣ - 'video _ ts' барои такрорӣ ва баҳсҳо.

Folback: Вақте ки WebRTC таназзул меёбад, гузариши худкор ба LL-HLS → бо бастани гаравҳои дер.

6) Хатогиҳо, retras, вақтҳо

Қоидаҳои умумӣ:

Ҳама зангҳои S2S бо танаффуси 800-1500 мс, бо таваққуфи экспоненсиалӣ ва Jitter бармегарданд, аммо бидуни дубора дебет кардани пул (idempotency).

Рамзҳои хатои ҳамён:

'ФОНДҲОИ НОКИФОЯ', 'LIMIT _ EXPOSTED', 'ACCOUNT _ LOCKED', 'DUPLICATE _ TRANSACTION', 'LATE _ BET', 'CURRENCY Y _ MISMATCH'.

Андозаи хатогӣ:

json
{
"хато": "INSUFFICIENT_FUNDS," "паём": "Тавозуни 18. 00 <25 лозим буд. 00" ", transaction_id": "trx-7a2df-001"
}

7) Бонусҳо, freespins, суғурта

Дар баробари ҳамёни "пул", тавозуни бонус метавонад вуҷуд дошта бошад: сарборӣ манбаи аз ҳисоб хориҷ шуданро нишон медиҳад: CASH	БОНУС '.
Барои бозиҳои зинда, суғурта/тарафҳо кам нестанд (масалан, дар blackjack) - ин амалиётҳои алоҳида бо маҳдудиятҳо ва коэффисиентҳои худ мебошанд.
Қоидаҳои яклухткунӣ: бонкдорӣ (нимашаб ҳам) ё ба манфиати плеер/оператор - бояд дар конфигуратсияи ҳамгироӣ муқаррар карда шавад.

8) Бозии масъулиятнок ва маҳдудиятҳо

Парчамҳои сеанс: 'худ _ истисно', 'cooldown _ do', 'loss _ limit _ left', 'time _ limit _ left'.

Провайдер метавонад пеш аз ҳар як дебет 'validate _ limits' дархост кунад.

Платформа метавонад force_close_session оғоз кунад: плеер истисно карда мешавад/аз ҳад зиёд аст → провайдер равзанаи букмекериро пӯшидааст ва дар гаравҳои нотамом бармегардад.

9) Бехатарӣ ва риояи

MTLS барои S2S, HSTS, рӯйхати қатъии IP-allowlist.

JWT/JWS бо TTL кӯтоҳ барои нишонаҳои пешакӣ, санҷиши аудитория/эмитент.

Имзои веб-дастгоҳҳои провайдер (HMAC-SHA256 бар бадан).

Гузоришҳои фаъолияти дилерҳо, такрори мудаввар, аудити тағйирнопазир (нигаҳдории WORM).

Нигоҳдории маълумоти шахсӣ - кам кардани PII, токенизатсияи 'player _ id', мӯҳлати нигоҳдории юрисдиксия (GDPR ва аналогҳо).

Бастани гео-манъкунӣ ва мамнӯъиятҳо аз ҷониби юрисдиксия дар сатҳи Create

10) Оштӣ ва молия

10. 1. Ҳисоботҳои соатӣ/ҳаррӯза

Провайдер дар бораи 'round _ id → total_bets, total_wins, пардохтҳо' ҳисобот медиҳад. Платформа муттаҳид мешавад:

Қарзҳо = Σ гаравҳо, қарзҳо = Σ бурдҳо + баргардонидан, Delta = GGR (аз ҷумла мукофотпулӣ/jackpots/комиссияҳо).

Андозаи гузориш:

json
{
"сана": "2025-10-18", "асъор": "EUR", "ҷадвалҳо": [{
"table_id": "ru-11", "давраҳо": 1260, "total_bets": "45230. 00", "total_payouts": "43012. 50", "jackpot_contrib": "302. 00", "provider_fee": "2. 5%"
}]
}

10. 2. Сенарияҳои Rollback

Даври видеоӣ/ҳикоявӣ ба нокомӣ дучор шуд. бекор карда шуд: провайдер ба ҳама гаравҳо дар давр "бозгашт" мефиристад.

Коркарди дебетии дукарата дар платформаи → 'DUPLICATE _ TRANSACTION' ва 200 OK бо ҳамон натиҷа ба даст оварда шудааст.

11) Чорабиниҳои чат, модератсия ва UI

Чорабиниҳои Чат тавассути канали алоҳида (Websocket # 2) бо филтрҳои stopword мегузаранд.

Эълонҳои система (гарави наздик, рӯйхати ғолибон) - танҳо аз манбаи провайдери боэътимод, имзошуда/мӯҳлатнок.

12) Санҷиш ва сертификатсия

Провайдери Sandbox: натиҷаҳои собит, қобилияти маҷбур кардан. натиҷа '.

Контури QA: ҷадвали санҷишӣ бо тирезаҳои буридашудаи гарав (5-8 c) ва ҷараёни босуръат.

Бор кардан: моделиронии 5-10 ҳазор бозигарони ҳамзамон, дебетҳои баландтарин дар як сония (TPS) нақшаи 1. 5.

Сертификатсияи ҳамгироӣ: рӯйхатҳои назоратӣ барои номутобиқатӣ, асъор, яклухткунӣ, қатъкунии коркард, риояи маҳдудиятҳо ва худдорӣ.

13) Метрика ва SLO

Инҳо: таъхири миёна/95p барои 'debit/credit', Web

Продукт: меъёри қабули гарав, меъёри дермонӣ, сатҳи баҳс, меъёри пардохт, давомнокии ҷаласа, нигоҳдорӣ, ARPU/LTV.

Намунаҳои SLO:

99. 5% 'дебет' ≤ 1. 2 с, 99. 9% расонидани '. натиҷа '≤ 300 мс пас аз ислоҳ, Таъхири видео ≤ 2. 5 с барои 95p Web-RTC.

14) Бисёрҷанба, андозҳо, маҳаллисозӣ

Табдилдиҳӣ - берун аз провайдер: бозӣ ба таври қатъӣ бо асъори сессия кор мекунад.

Андозҳо/тарҳҳо - дар тарафи платформа бо 'қарз' (майдони 'нигоҳдорӣ').

Маҳаллисозӣ: 'lang', формати рақам/асъор, минтақаи вақт барои вақтсанҷ ва ҳисобот.

15) Имконоти ҳамгироӣ

1. Бевосита ба провайдер: назорат ва хусусияти максималӣ, аммо шартномаҳо/сертификатҳои алоҳида.

2. Тавассути агрегатор: фарогирии зуд аз ҷониби провайдерҳо, схемаҳои ягона, баъзан чандирии камтар.

3. Гибрид: ҷадвалҳои болоӣ мустақиман, боқимонда тавассути агрегатор.

16) Мушаххасоти хурд (ҳамагӣ)

16. 1. Воридоти Websocket (муштарӣ ба провайдер)

json
{"навъи ":" Бет. ҷой, "Бет": {
"маблағ": 25, "интихоб":" 17", "table_id":"ru-11"
}, "idempotency_key":"c3a2-...-001"}

16. 2. Баромади Web-Socket (провайдер ба муштарӣ)

json
{"навъи ":" Бет. қабул кард," "bet_id":"b-8821," "seq ": 12031}
{"навъи ":" давр. пӯшида," "round_id":"r-...001," "seq ": 12050}
{"навъи ":" давр. натиҷа," "натиҷа ": {"рақам ": 17," ранг":" сиёҳ"}, "seq ": 12070}
{"навъи ":" пардохт. сохта шудааст," "маблағ": 875, "асъор":" EUR", "seq ": 12075}

16. 3. Ҳамён S2S (провайдери платформа ↔)

'POST/ҳамён/дебет' (idempotent)

'POST/ҳамён/қарз' (idempotent)
'POST/ҳамён/бозгашт' (idempotent)

Имзои HMAC, 'Timestamp', 'Nonce', муҳофизати такрорӣ (TTL ≤ 60 c).

17) Парвандаҳои Edge ва чӣ гуна бастани онҳо

Қатъи бозингар: Бет фиристода шуд, ҳеҷ тасдиқи → такрор бо ҳамон 'Idempotency-Key'; сервер бо ҳамон ҳолат ҷавоб медиҳад.

Тағири дилер/саҳни давр: бекоркунии худкор ва пурра "бозгашт".

Номутобиқатии асъор: 'CURRENCY _ MISMATCH' + сабти рӯйдодҳо; бозӣ то барориши сессия баста мешавад.

Худидоракунӣ дар вақти бозӣ: фавран 'force _ close _ session', бозгашт бенатиҷа.

Тағйир додани сифати видео: танҳо муштарӣ, ҳеҷ гуна таъсир ба вақтсанҷ/гарав.

Аз нав ба даст овардани Web-Socket: бидуни гум кардани фармоиш - навбати рӯйдодҳо бо 'seq', "сайд кардан" пазмон шуд.

18) Рӯйхати санҷиши оғози истеҳсолот

Бехатарӣ

шаҳодатномаи pinning MTLS +, IP-allowlist.
Ҳамаи веб-китобҳоро имзо кунед ва 'Timestamp '/' Nonce' -ро тафтиш кунед.
Mini-PII: танҳо 'player _ id' (tokenized).

Эътимоднокӣ

Шиносоии ҳама амалиётҳои пулӣ.
Такрори мудаввар ва аудити тағйирнопазир.
WebRTC → LL-HLS худкор-folback.

Маҳсулот

Маҳдудиятҳо/бозии масъулиятнок дар вақти воқеӣ татбиқ карда мешаванд.
Миллатҳо дар вақти гарав.
Панели панели SLO + огоҳиҳои 24/7.

Ҳамгироии мустақими API як бастаи ҷараёни камдаромад, автобуси ҳодиса ва ҳамёни бесифат бо талаботҳои қатъӣ барои фармоиш, вақт ва амният мебошад. Татбиқи бомуваффақият ба он такя мекунад: давраи қатъии ҳаёти гаравҳо ва даврҳо, мувофиқати тасдиқшаванда (мусолиҳа), ҳифзи маълумот ва маҳдудиятҳои бозӣ - ва "пахши зебо" -ро ба маҳсулоти боэътимоди сертификатсияшуда табдил медиҳад.