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

Интегратсияи студия (провайдери бозӣ) бо платформа/агрегатор як қатор зангҳои синхронӣ ва асинхронӣ дар атрофи сессия, ҳамён, натиҷаи чарх ва телеметрияи ҳодиса мебошад. Дар зер харитаи мухтасар, вале амалӣ дар бораи он, ки ҳама чиз бидуни дард барои таҳиягарон ва мувофиқат мепайвандад.

1) Меъморӣ дар хурмо аз дасти шумо

Актёрҳо:

Студияи RGS (Сервери дурдасти бозӣ) - мантиқи бозӣ, RNG, мукофотпулӣ, jackpots.
Платформа/Агрегатор - масир, биллинг, таблиғ, мувофиқат.
Оператор - ҳамёни бозингар, KYC/RG, намоиш.
Мизоҷ - контейнери бозии веб/мобилӣ (iframe/webview/native).

Автобусҳои асосӣ:

Ҳамоҳанг кардани API: ҷаласаҳо, ҳамён, натиҷа.
Async/Event Bus: чорабиниҳои чарх, мукофотпулӣ, jackpots, RG, хатогиҳои техникӣ.
Метамаълумот/каталог: бозиҳо, бозорҳо, профилҳои RTP, маҳалҳо.

2) Протоколҳо ва қарорҳои асосӣ

Нақлиёт: HTTPS/JSON (баъзан GRPC барои Event Bus/Wallet).

Версия: 'Қабул кунед: ариза/внд. rgs. v1 + json 'ё '/v1/...'; таназзули мутобиқат - танҳо тавассути версияҳои нав.

Шиносоӣ: 'game _ id', 'build _ hash', 'operator _ id', 'session _ id', 'round _ id', 'spin _ id'.

Вақт: ба таври қатъӣ UTC, ISO-8601 бо миллисекундҳо.

Асъор: ISO-4217 + дақиқӣ (воҳидҳои хурд). FX - тарафи оператор/агрегатор.

3) Аутентификатсия ва авторизатсия

Сервер-ба-сервер: OAuth2 Маълумоти муштарӣ или HMAC-podpisь ('X-Signature: HMAC_SHA256 (сарборӣ, shared_key)').

Ҷаласаи бозингар: JWT-и кӯтоҳмуддат (платформаи аломатҳо) c 'sub', 'geo', 'rg _ flags', 'exp', 'aud = studio'.

Рӯйхатҳои дастрасӣ: IP барои ҳалқаҳои истеҳсолӣ + MTLS иҷозат медиҳад.

4) Моделҳои ҳамён: дебетӣ/қарзӣ ва интиқол

A) Дебет/Қарз (ҳангоми парвоз):

1. Платформа RGS-ро даъват мекунад: 'Spin

2. Дар баробари ин, платформа дар ҷои оператор "дебет (саҳм)" ва "қарз (бурд)" месозад.

Тарафдор: Муҳосиботи оддӣ. Омӯз: зангҳои бештари шабака, талаботҳои қатъӣ барои номутобиқатӣ.

B) Интиқол (тавозуни сессия):

1. Дар оғози ҷаласа, платформа дар RGS 'интиқол (маблағ)' мекунад.

2. Ҳангоми гардиш, худи RGS сессияро мувозинат мекунад; ба итмом мерасад - 'интиқол (боқимонда)'.

Тарафдор: Чатҳои камтар ҳамён. Омӯз: баҳисобгирии "пул дар паҳлӯи RGS", хатарҳои иловагӣ ва мусолиҳа.

Тавсияҳо:

Барои слотҳо, дебет/қарз бо калидҳои idempotent бештар истифода мешаванд.

Дар spins ва мусобиқаҳои ройгон доштани намудҳои алоҳидаи Бет 'spin _ type = ройгон қулай аст	таблиғ '.

5) Идемпотентсия ва пайдарҳамӣ

Ҳар як қадами пул бояд 'idempotency _ key' -и беназир дошта бошад (масалан, 'round _ id' ё 'spin _ id').

Нусхаҳо ('HTTP 409/425') ҳамон натиҷаро бармегардонанд, на "хатогии аллакай иҷрошуда".

Маҳз як маротиба ноил шудан душвор аст, аз ин рӯ мо ҳадди аққал як маротиба + idempotency месозем.

Idempotence ба 'дебет', 'қарз', 'jackpot _ саҳм', 'bonus _ award' дароз карда мешавад.

6) Схемаҳои дархости калидӣ (ихтисоршуда)

6. 1. Оғози сессия

json
POST/rgs/v1/ҷаласаҳо
{
"session_id": "s-...", "operator_id": "op-...", "player_id": "p-...", "game_id": "g-Book"..., "build_hash": "sha256:...", "jwt": "ey-" Gci..., "geo": "DE", "асъор": "EUR," "rg_flags": {"худ _ истисно": дурӯғ ", time_limit_min": 60}
}

6. 2. Спин (дебет/қарз)

json
POST/rgs/v1/spins
{
"spin_id": "spin-...", "round_id": "rnd-"..., "session_id": "s-...", "сутун": {"маблағ": 1. 00, "асъор": "EUR"}, "spin_type": "нақд", "idempotency_key": "spin-"...
}

Ҷавоб:

json
{
"spin_id": "spin-...", "натиҷа": {
"win": {"маблағ": 3. 40, "асъор": "EUR"}, "хусусиятҳо": [{"навъи": "bonus _ trigger", "name": "Free
}, "rgs_txns": [
{"навъи ": "jackpot _ саҳм"," маблағ": 0. 01}
] ", telemetry_ref": "evt-"..
}

6. 3. Автобуси чорабинӣ

json
POST/rgs/v1/events/партия
{
"рӯйдодҳо": [
{
"намуди ": "spin _ тамом", "ts ":" 2025-10-20T11: 22:33. 123Z, "" spin_id":"spin-..., "" round_id":"rnd-..., "сутун": 1. 00, "бурд": 3. 40, "асъор":" EUR", "game_id":"g-...,""build_hash":"sha256:...," "player_id":"p-...,""operator_id":"op-...," "spin_type":"cash"
}
]
}

7) Версия сохтан ва сохтани бозор

'build _ hash' (SHA-256) - дар ҳар як чорабинӣ талаб карда мешавад.

Global vs Market build: забон, огоҳӣ, маҳдудиятҳои нархҳо, профили RTP.

Платформа тасдиқ мекунад: "ин як биноест, ки айни замон бозӣ карда мешавад, ки ба шаҳодатномаи ин кишвар мувофиқат мекунад".

Матритса: 'game _ id кишвар .

8) RNG, Математика ва Такрори

RNG дар RGS зиндагӣ мекунад; мантиқи тиҷорат имконияти парвозро тағйир намедиҳад.

Барои криминалистика: 'тухм/nonce' дар як давр/чарх + версияи механикӣ.

Бозсозӣ: бо 'spin _ id '/' насл', RGS натиҷаро дубора интишор мекунад ва саёҳати аудиториро медиҳад.

9) Бозиҳои масъул (RG) ва қалмоқҳои мувофиқат

Калидҳои вақт/маҳдудият: 'session _ time _ ms', "ёдраскунӣ", танаффус; 'rg _ event' дар автобуси ҳодиса.

Худидоракунӣ/блок: бо парчам - фавран '403 RG_BLOCKED'.

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

10) Хатогиҳо, бозпас ва SLA

Рамзҳо: '400' (тасдиқкунӣ), '401/403' (аутентификатсия/RG), '409' (ихтилофи номутаносиб), '422' (хатои тиҷорат), '429' (меъёри меъёр), '5xx' (муваққатӣ).

Сиёсати бозгашт: экспоненсиалӣ, бо калиди idempotent ва deduplication дар қабулкунанда.

SLA ≥ 99 мавҷудияти API. 9%, таъхири p95 барои "чарх" ≤ 200 -300 ms (минтақавӣ), Event Bus - вақти воқеӣ <60 s.

11) Мушоҳида ва аудит

Сабтҳо: гузоришҳои серверро бо таносуби 'trace _ id' ҷудо кунед.

Нишондиҳандаҳо: таъхири p95/p99, сатҳи хатогӣ аз рӯи усулҳо, дуршавии басомадҳои RTP/бонус, таносуби "чархҳои эластикӣ".

Огоҳиҳо: аз ҷониби SLA, аз рӯи аномалияҳои математикӣ, аз ҳисоби зиёд шудани нокомии ҳамён.

Аудит: Нигоҳдории WORM барои чорабиниҳои гарав/натиҷа; содирот аз рӯи талабот.

12) Бехатарӣ

MTLS + TLS 1. 2 +, HSTS, CORS-и қатъӣ дар боркунаки муштарӣ.

Гардиши калидҳо, аломатҳои кӯтоҳи TTL, чекҳои JTI/nonce.

Анти-тампер барои муштарӣ: имзоҳои дороиҳо, санҷиши якпорчагӣ, муҳофизати debugger.

Асрҳо - танҳо дар мудири махфӣ; нест "калид дар конфигуратсияи бозӣ".

13) Муҳитҳои санҷишӣ ва сертификатсия

Қуттии қуттӣ: ҳамёнҳои афсонавӣ, RNG детерминистӣ (тухми собит), худкори нокомии сенарияҳои RG.

Саҳна: нусхаи prod-infra бе пули воқеӣ.

Баста барои лабораторияҳо: GDD/математика, маълумотномаи RNG, диаграммаҳои журнал, сохтан ва такрори такрорӣ.

14) Promos ва jackpots дар API

Spins ройгон: интиқоли пакет: 'grant _ free _ spins (ҳисоб, bet_size, rtp_profile?)'; чорабиниҳо дар RGS гузаронида мешаванд ва сабт карда мешаванд.

Мусобиқаҳо: атрибут 'spin _ type = мусобиқа' + агрегатҳои инфиродӣ дар Event Bus.

Jackpots: 'jackpot _ саҳм' ва 'jackpot _ win' ҳамчун амалиёти алоҳида; пайдарҳамӣ тавассути idempotency ва рӯйдодҳои "имзошуда".

15) Ҳисоботдиҳӣ ва ҳисоббаробаркунӣ

Блоки выгрузок: 'spins _ total', 'мувофиқ _ spins', 'гардиш', 'ggr', 'шабака', 'jackpot _', 'bonus _ cost', 'royalty _ day'.

Пардохти ҳар як чарх/гардиш: ҳисоб аз рӯи 'қобили қабул _ spins' ё 'Σ саҳм × меъёри'.

Rev-share: аз 'Netwin' пас аз 'шаршара' нигоҳ медорад; семоҳаи ҳақиқӣ барои FX/истисноҳо.

16) Пайдарпайии маъмулӣ (диаграммаҳои калимаҳо)

Спин (дебет/қарз):

Client → Платформа: Платформаи Старт

Spins ройгон:

Платформа → RGS: Grant

17) Идоракунии тағирот ва ҳамоҳангсозӣ

Шартнома-аввал: OpEN API/Protobuf манбаи ягонаи схемаҳо мебошад.

Semver: танҳо майдонҳо илова кунед; нест кардан/тағир додан - дар/v2.

Параметрҳои хусусият-Имконот (Bonus Buy/Ante) танҳо тавассути профилҳои тасдиқшуда.

Радкунӣ: эълом кунед → давраи имтиёзнок → қатъ дар минтақаҳои ғайрифаъол.

18) Рӯйхати санҷишҳо

Studio Платформа

Хусусиятҳои кушодаи API/GRPC ва борҳои намунавӣ.
ID 'empotency' spin/debit/credit/jackpot '.
'build _ hash' ва бозор феҳристро месозад.
Нусхаҳои RNG ва сабти аудит.
RG қалмоқҳо ва хатогиҳои '403 RG_BLOCKED'.
Сандбокс бо тухми ислоҳ, ҳамёни санҷишӣ ва скриптҳои худкор.

Платформа → Студия

Имзои JWT бо TTL-и кӯтоҳ, IP-рӯйхати IP, MTLS.
Тасдиқи сохтани бозор ва шаҳодатномаҳо.
Ҳодисаҳои автобус ва панели панелҳо (таъхир/хато/RTP drift).
Квотаҳо ва меъёрҳо бо фикру мулоҳизаҳои софдилона '429-Retry-After'.
SLA/Ҳодисаҳо/Истинодҳо 24 × 7.

19) 30-60-90 нақшаи роҳандозӣ

0-30 рӯз

Дар бораи шартномаҳои API ва схемаҳои чорабинӣ розӣ шавед, модели ҳамёнро интихоб кунед.

Қуттии регро баланд кунед: RNG-насли собит, ҳамёни санҷишӣ, автотестҳои idempotency.

Феҳристи 'build _ hash' ва бозори ибтидоии матритса.

31-60 рӯз

Ҳамён ва ҳамгироии чарх; фаъол кардани Автобус ва панели чорабиниҳо.

Санҷишҳои сарборӣ (p95/p99), retrai/idempotency, сенарияҳои бетартибиҳои шабака.

Мувофиқат: RG-қалмоқҳо, маҳалҳо, тамғакоғазҳо; баста ба лаборатория.

61-90 рӯз

Озмоишӣ барои 1-2 оператор, A/B барои promo (spins/мусобиқаҳои ройгон).

Ворид шудан ба воқеият/ҳисобот, RTP огоҳиҳо/бонус-freq.

Омодасозии такмилдиҳии v2: чорабиниҳои гурӯҳӣ, g: RPC барои ҳамён, масири гео.

20) FAQ кӯтоҳ

RTP/версия дар куҷо тафтиш карда мешавад? Дар платформа: 'build _ hash' ↔ сертификат ↔ кишвар.

Оё RTP метавонад динамикӣ тағир ёбад? Не, ин тавр нест. Танҳо профилҳои қаблан тасдиқшуда ва танҳо гузариши бозор.

"Дебети дукарата" -ро чӣ гуна бояд ҳал кард? Калиди Idempotent + ҳолати нигоҳдории транзаксия; redo-Натиҷаро бармегардонад.

Оё ба ман GRPC лозим аст? Барои ҳамён/чорабиниҳо дар ҳаҷми баланд муфид аст; REST барои панели метамаълумот/маъмурӣ боқӣ мемонад.

Интегратсияи устувор шартномаҳо + idempotency + мушоҳида мебошад. Схемаҳои шаффофи рӯйдодҳо, назорати сохтмон/бозор, қалмоқҳои RG ва интизоми версия 90% хатарҳоро дар оғоз бартараф мекунанд. Минбаъд - автоматикунонии таблиғот ва гузоришдиҳӣ, SLA-и сахт ва рушди бодиққати API бидуни тағироти "шикастан".