Протоколҳои умумии коммуникатсионӣ

1) Чаро экосистема ба протоколҳои ягона ниёз дорад

Экосистема аз операторҳо, студияҳо/RGS, агрегаторҳо, PSP/APM, провайдерҳои KYC/AML, филиалҳо ва хадамоти таҳлилӣ иборат аст. Протоколҳои муштараки муштарак "зоотехникӣ" -и интегратсияро истисно мекунанд, суръатбахшии киштӣ, кам кардани арзиши дастгирӣ ва хатари ҳодисаҳо, инчунин мутобиқатро ҳангоми миқёс (уфуқӣ, амудӣ ва диагоналӣ) таъмин мекунанд.

Ҳадафҳо: созгорпазирӣ аз қуттӣ, SLO-ҳои пешгӯишаванда, амнияти маълумот, муҳоҷирати такрорӣ.

2) Қабати интиқол ва форматҳо

HTTP/2/3, GRPC - барои API-ҳои синхронӣ бо таъхири кам; Web ​ ​ Socket - барои рӯйдодҳои ҷараён/пешсафон; WebRTC (SRTP/QUIC) - барои мундариҷаи аудио/видео.

• JSON - API-ҳои берунии B2B ва вебҳукҳо (хондан).
• Протобуф/Авро - интегратсияи дохилии автобус/амиқ (таҳаввулоти фишурдасозӣ/ноҳиявӣ).
• Фишурдасозӣ/ҳатмӣ: gzip/br барои JSON; zstd барои Protobuf/Avro.
• Маҳаллӣ/вақт: ISO-8601 дар UTC, миқдор дар воҳидҳои ҳадди ақали пулӣ (бутун).

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

OAuth2/OIDC барои барномаҳои муштарӣ/шарикӣ (аломатҳои кӯтоҳмуддат, PKCE, миқёс).
MTLS барои S2S байни минтақаҳои боэътимоди JWS/HMAC - имзои дархостҳо ва веб-китобҳо.
RBAC/ABAC: нақшҳо ва сифатҳо (юрисдиксия, иҷорагир, сатҳи хатар).
Калидҳо ва гардиш: KMS/Vault, мӯҳлати кӯтоҳ, гардиши автоматӣ (аз ҷумла JWKS).

Назорати egress, доменҳои иҷозатдиҳӣ ва ASN, DNSSEC/Do

Ҷудокунии иҷорагир: калидҳои ҳар як иҷорагир, квотаҳо, маҳдудиятҳо, фазои ном дар шина.

4) Шартномаҳои API (REST/GRPC) - Canon

Версия: '/v {n} 'дар URI барои REST;' баста. v ВН 'барои GRPC. Таҳаввулоти хурд - бенуқсон; шикастани тағирот - тавассути майдони нав. Депрессия аз рӯи сиёсат (ниг. § 12).
Idempotency: 'Idempotency-Key' дар амалиёти POST/PUT/PATCH/интиқодӣ; сарфа барои N соат.
Пагинатсия: курсорҳо ('next навъбандии пайваста.
Маҳдудиятҳо: '429 Дархостҳои аз ҳад зиёд' + сарлавҳаҳои квота ('X-Rate' Limit- '), ҷиттер дар ретрас.
Хатогиҳо: рамзҳои хондан/зеркодҳо, 'коррелятсия', харитаи майдони тасдиқкунӣ.
Вақти истироҳат ва ақибнишинӣ: таъхири экспоненсиалӣ + ҷиттер; хатогиҳои хатарнокро бартараф накунед.
Сиёсати мутобиқат: тағйирнопазирии маънои саҳро; майдонҳои нав - ихтиёрӣ.

5) Модели чорабинӣ ва автобус (EDA)

Феҳристи схема: шартнома барои ҳар як ҳодиса, эволютсия бо мутобиқати ақиб.

• 'click', 'session', 'bet '/' spin', 'round _ start '/' round _ натиҷа',
• 'deposit '/' хуруҷ', 'psp _ auth', 'kyc _ status', 'қаллобӣ _ сигнал',
• 'мукофот _ дода шудааст', 'leaderboard _ update', 'feature _ toggle'.
• Калидҳои ҳизбӣ: 'player
• Таҳвил: ҳадди аққал як маротиба бо номутобиқатии тиҷорат; барои ҷамъи пулӣ - saga/txn-outbox.
• Фармоиш: "фармоиши кафолатдодашуда дар дохили калид", калидҳои салиб - тавассути оркестр.
• Семантикаи вақт: 'event бобокалон ба '(event' Id 'idempotency' Key) '.

6) Webhooks ва кафолатҳои таҳвил

Имзо: JWS/HMAC бо '(timestamp) ва' kids ', санҷиши тиреза ± 5 дақиқа, такрорӣ манъ аст.
Retrai: бозгашт бо jitter то дақиқаҳои T, ислоҳ кардани кӯшишҳо, танҳо дар 5xx/timeout.
Idempotency: 'event' Id '+ имзои бадан; коркарди "ҳадди аққал як бор".
Феҳристи рӯйдодҳои Webhook: таҷдиди таърих ҳангоми ҳамоҳангсозӣ.
Амният: MTLS то ҳадди имкон, рӯйхати иҷозати IP/ASN, CSRF ба гулӯҳои сервер дахл надорад.

7) Маълумот ва махфият (тарроҳии махфият)

Кам кардани PII: токенизатсияи идентификаторҳо ('player

Шартномаҳои маълумот: DPA/DPIA, ҳадафҳо, мӯҳлати нигоҳдорӣ, ҷараёни фаромарзӣ (кишварҳои Whitelist).
Сиёсати аудит/насл: кӣ/кай/чаро; гузоришҳои тағйирнопазир (WORM).
Қоидаҳои RG/ахлоқӣ: манъи пешниҳодҳои хашмгин барои гурӯҳҳои осебпазир; заминаи возеҳи ҳуқуқӣ.

8) Мутобиқат ва муомилот

Мувофиқати қавӣ - ҳамён/тавозун/пардохт.
Оқибат - намоишҳо, лидерҳо, телеметрия.
Sagas барои муомилоти тақсимшудаи тиҷорат; ҷуброн барои бекоркунӣ.
Маҳз як маротиба ба маънои тиҷорат: калидҳои номатлуб ва коркардкунандагони детерминистӣ.

9) Мушоҳида ва SLO

Пайгирӣ: 'пайгирӣ' аз клик/webhook то пардохт/мукофот; паҳнкунӣ ('traceparent W3C').
Нишондиҳандаҳо: p50/p95/p99 API, ақибмонии брокер, пардохтҳои CR/CCL, пешсафони E2E.
Гузоришҳо: сохташуда, бе маълумоти шахсӣ; ниқоби токен/калид.
Рӯйхати SLO: login p95 ≤ 300-500 ms; амонат p95 ≤ 1. 5–2. 0 с; бет/спин p95 ≤ 150-250 мс; расонидани ҳодиса ≥ 99. 9%.

10) Иҷро, квотаҳо, муҳофизати тӯфон

Меъёри маҳдудкунӣ (сатил/сатил) дар L7 ва дар сиёсати фикрию.
Backpressure: навбатҳо пеш аз нозуки болооб (PSP/KYC).
Баровардани берунӣ: "хунуккунӣ" -и пушти ноустувор.
Circuit-breaker - Ҳангоми гузаштани ҳадди ниҳоии хатогӣ/ниҳонӣ риштаро пӯшед.
Ҳиссаи одилона: квотаҳо аз ҷониби иҷорагир/канал/минтақа; афзалияти доменҳои интиқодӣ.

11) Мутобиқат ва меъёрҳои санҷиши SDK

SDK: Мизоҷони HTTP/GRPC, имзои дархост, бозпас гирифтани jitter, idempotency, cursors.
Санҷишҳои шартномавӣ: Postman/Newman/GRPC-мутобиқат, PSP/KYC/тренажерҳои студия.
Матритсаи мутобиқат: версияҳои API/SDK, схемаҳои дастгирӣ, сиёсати декоратсия.
Синтетика: генераторҳои ҳодиса ва транзаксия, 24/7 қуттиҳои сиёҳ барои назорат.

12) Версия ва депрессия (Идоракунии тағирот)

Нашри асосӣ ҳар моҳ N, бо равзанаи мувозӣ ≥ 6-12 моҳ.
Тағироти ночиз - илова кардани майдонҳо/усулҳои ихтиёрӣ бесамар мебошанд.
Decrement: эълон → огоҳӣ дар сарлавҳаҳо/ҷавобҳо → парчам дар ченакҳо → қатъкунӣ тибқи нақша.
Муҳоҷирати схемаи чорабиниҳо - стратегияи иловашуда + адаптерҳои прокси дар марзҳо.

13) Амнияти протокол

Боварӣ ба сифр: MTLS дар ҳама ҷо, мазҳабҳои кӯтоҳмуддат, принсипҳои камтарин имтиёз.
Доираҳои махфӣ: ҷудокунии калидҳои хондан/навиштан/маъмурӣ.
Муҳофизат аз такрорӣ: равзанаи nonce/time дар имзоҳо; манъи истифодаи такрорӣ.
Филтрҳои WAF/бот: муҳофизат аз қаллобӣ/клик; пасти мусбати бардурӯғ.
Минтақаҳои фурӯшанда: microsegmentation, VPC/фазои инфиродӣ, рӯйхати egress-иҷозат.

14) Ҳодисаҳо ва ДР

Тартиби ҳуҷраҳои ҷангӣ: тугмаи таваққуф барои доменҳо (мундариҷа/PSP/KYC), RACI, SLA барои пакети пайгирӣ.
Сенарияҳои DR: нуқтаҳои воридкунии дороиҳо (Anycast/GSLB), буридани ≤ 60-90 с, машқҳои семоҳа.
RCA: қолабҳо бе ёфтани гунаҳгор, муоширати L3↔L7, навсозиҳо ба протоколи/SDK/Runbook.

15) Нишондиҳандаҳои муваффақияти протокол

Мутобиқат: таносуби шариконе, ки аз санҷишҳои мутобиқат гузаштаанд; вақти боркунӣ (TTO).
Эътимоднокӣ: интегратсияи замонавӣ, p95 API/автобус, ҳиссаи вебхукҳои муваффақ.
Амният: Ҳодисаҳои PD = 0, вақти гардиши калидӣ, ҳиссаи трафики MTLS.
Иқтисодиёт: арзиши як rps/txn/ҳодиса, пастшавии хароҷот барои хидмат, вақти муҳоҷират.
Маҳсулот: Баланд бардоштани FTD/ARPU/LTV аз стандартизатсия (ихроҷи CCD/пардохт камтар).

16) Анти-намунаҳо

"Шакли ройгон" -и чорабиниҳо: набудани диаграммаҳо ва версияҳо → рондани намоишҳо ва таҳлил.
Дарвозаи ягонаи L7 бидуни N + 1: SPOF ва гулӯи танг барои webhooks/PSP.
Retrai Unlimited/Jitter: Тӯфони ҳаракат, Транзаксияи дукарата.
PD-и хом бар ивази: токенизатсия/DPIA → хатарҳои танзимкунанда нест.
Саҳифаҳои ҷуброншаванда: холигоҳҳо/нусхаҳо дар зери сарборӣ.
Асрори "абадӣ" ва IP статикӣ бидуни назорати egress.
Бе тирезаи мувозӣ ва адаптерҳо шикастани тағирот.

17) Рӯйхати назорати амалисозӣ

1. Канони API-ро қабул кунед (версия, idempotency, pagination, хатогиҳо).
2. Феҳристи схема ва харитаи домени тугмаҳои мавзӯъ/ҳизбро ворид кунед.
3. MTLS + JWS/HMAC-ро барои S2S ва webhooks ӯҳдадор кунед; автоматикунонии гардиши калидҳо/JWKS.
4. Муқаррар кардани маҳдудиятҳо/бозпардохтҳо/CB/outlier-ejection ва квотаҳо барои як иҷорагир.
5. Васеъ кардани пайгирӣ/ченакҳо/гузоришҳо бо як 'пайгирӣ'; рӯйхати SLO-ро тасдиқ кунед.
6. DPA/DPIA-ро имзо кунед, токенизатсияро фаъол созед ва сиёсатро нигоҳ доред/нест кунед.
7. Эҷоди маҷмӯи SDK ва мутобиқат; Сиёсати тамомшавиро ислоҳ кунед.
8. Гузаронидани машқҳои DR/бетартибӣ ва расму оинҳои ҷангӣ; "оғози сиёҳ" дар маҷмӯи ҳадди аққал.
9. Татбиқи каталоги протокол (портали шарикӣ): мушаххасот, намунаҳо, тренажерҳо, қуттича.

18) Харитаи роҳи эволютсия

v1 (Бунёд): Канони REST/g

v2 (Интегратсия): лӯлаи муҳоҷират, санҷишҳои мутобиқат, SDK, муҳаррики қоидаҳо барои квота/бозхонд.
v3 (Автоматика): автоматизатсия аз ҷониби SLI, қуттиҳои худидоракунии хидматрасонӣ/тренажерҳо, адаптерҳо байни версияҳо.
v4 (Идоракунии шабакавӣ): кумитаи протоколи шарики муштарак, SLO/кредит/ҷаримаҳои муштарак, сиёсати муштараки PO/канорӣ.

Хулосаи мухтасар

Протоколҳои маъмулии ҳамкорӣ ин "забон" -и экосистема мебошанд: шартномаҳои ягонаи API ва рӯйдодҳо, амнияти қатъӣ (MTLS/JWS), кафолати аблаҳӣ ва таҳвил, мушоҳидаҳо ва SLO, муҳоҷирати идорашаванда ва DR. пас аз канон, иштирокчиён босуръат, камтар меафтанд, миқёсро осонтар мекунанд ва афзоиш меёбанд пешгӯишаванда - мутобиқи талаботи дахолатнопазирӣ ва ҳуқуқӣ.