Таҳлил ва ченакҳои API
1) Чаро қабати алоҳидаи API
Ҳақиқати ягона барои KPI: истисно "зоопарк SQL".
Суръати маҳсулот: фронтҳо, панелҳои шарикӣ, муштариёни мобилӣ агрегатҳоро бидуни дастрасии мустақим ба DWH мегиранд.
Амният ва мувофиқат: токенизатсия, ниқобҳо, маҳдудиятҳои гео, филтрҳои RG/AML.
Миқёс: кэш, пререндерҳо, CDN, шартномаҳои устувор.
2) Таксономия: ченакҳо, андозаҳо, далелҳо
Далелҳо: гаравҳо, бурдҳо, амонатҳо, чорабиниҳои KYC, мудохилаҳои RG.
Андозаҳо: сана/вақт (тақвимҳо), бозӣ/провайдер, бренд/кишвар, канал/дастгоҳ, плеер (токен).
Нишондиҳандаҳо: GGR, NGR/NET, ARPPU, D1/D7/D30 нигоҳдорӣ, басомади амонатӣ, зидди қаллобӣ FPR, хатари RG.
Воҳидҳо: асъор (FX), вақт (TZ), ҳаҷм/ҳисобкунакҳо (idempotent!).
Семантикаи KPI: таърифҳо дар шартномаҳои BI, версияҳои KPI собит карда мешаванд.
3) Шартномаҳои маълумот ва BI
Схема: майдонҳо, намудҳо, нобудшаванда, энум, воҳидҳо, асъор.
Семантикаи ченакҳо: формула, манбаъҳо, тирезаҳои маҷмӯӣ, филтрҳо.
Мутобиқат (SEMVER): Танаффусҳои MAJOR, MINOR майдонҳо илова мекунанд, ислоҳи PATCH.
DQ/SLA: тару тоза, мукаммалӣ, пайдарҳамӣ, таҳаммулпазирии номутобиқатӣ.
Махфият: 'pii: false', 'tokenized: ҳақиқӣ', манъи детокенизатсия.
yaml api: analytics. v2 resource: /metrics/revenue kpi: GGR schema_version: 2. 1. 0 dimensions: [date, brand, country, provider, game]
metrics: [ggr, stakes, wins, bets_count]
sla: {freshness: PT15M, completeness: ">=99. 9%"}
privacy: {pii: false, tokenized: true}4) Меъморӣ
Дархости API (ҷамъбасти онлайн аз болои "тилло "/мукааб/fichestore).
API precompute (пешгузаштагони ба нақша гирифташуда, назари моддӣ).
Ҳодисаҳои API (ҳисобкунакҳо/сигналҳо).
Содироти API (боркуниҳои имзошуда, WORM барои аудит).
Кэш: дар хотира → Redis → CDN, калид = дархости hash + версия.
Мувофиқат: барои сабтҳои ниҳоӣ хонед-нависед, тару тозаи SLA барои агрегатҳо.
5) Интерфейс ва дархостҳо
5. 1 Филтрҳо/агрегатҳо/тирезаҳо
'filter': диапазонҳои сана ('аз/ба' UTC, огоҳии вақт), кишварҳо, брендҳо, бозиҳо, каналҳо, дастгоҳҳо.
'group _ by': андозаҳо.
'metrics': рӯйхати KPI-ҳо.
'window': 'DAY' WEEK 'MONTH' ROLLING _ 7D 'ROLLING _ 28D'.
'currency': 'гузориш додан' native ', стратегияи FX:' eod 'intray' txn '.
'sampling': барои дархостҳои вазнин (танҳо дар ҷое ки иҷозат дода шудааст).
5. 2 Мисолро дархост кунед
json
POST /v2/metrics/revenue
{
"range": {"from":"2025-10-01","to":"2025-10-31","tz":"Europe/Kyiv"},
"group_by": ["date","brand","country"],
"metrics": ["ggr","bets_count","net_revenue"],
"filters": {"country":["EE","LT","LV"],"brand":["alpha","beta"]},
"currency": "reporting",
"window": "DAY"
}5. 3 Намунаи посух
json
{
"schema_version":"2. 1. 0",
"kpi_definitions":["ggr@1. 7. 0","net_revenue@1. 3. 2"],
"range":{"from":"2025-10-01","to":"2025-10-31","tz":"Europe/Kyiv"},
"data":[
{"date":"2025-10-01","brand":"alpha","country":"EE","ggr":12450. 72,"bets_count":182342,"net_revenue":10732. 11},
{"date":"2025-10-01","brand":"beta","country":"EE","ggr":...}
],
"fx":{"strategy":"eod","rate_date":"2025-10-31"},
"dq":{"freshness_sec":420,"completeness":0. 9992},
"trace_id":"3d1a-...-c79"
}6) Пагинатсия, маҳдудиятҳо, навъбандӣ
Пагинатсия: 'лимит' (≤ 10к), 'курсор' (ношаффоф), навъбандӣ аз рӯи андоза/сана.
Вақт/қисман: посухҳои қисман танҳо барои KPI-и молиявӣ; молия - ё P200 ё P504.
Ҳудуди нархҳо: глобалӣ/аз рӯи калид/аз ҷониби иҷорагир; вокуниш 'X-Rate' Limit- '-ро дар бар мегирад.
7) Idempotence ва кэш
Idempotent GET/POST-read (бо бадан) бо 'Idempotency-Key'.
Калиди кэш = ҳаш (параметрҳо + версияи схема + нақш/иҷорагир/гео).
TTL: Вобастагии KPI (масалан, 'PT15M' барои даромад, 'PT5M' барои чорабиниҳо), бо лаҳзаи нав барқарор кунед.
8) Мувофиқат ва асъори вақт
Парчами вақти сафар барои гузоришҳои ретроспективӣ (версияҳои маълумот).
Қоидаҳои қатъкунӣ (пӯшидани рӯз/ҳафта).
FX: мо стратегияро ислоҳ мекунем, санаи курс дар ҷавоб.
Соат: ҳама мӯҳлатҳо ISO-8601, TZ лозим аст.
9) Амният ва махфият
mTLS/TLS1. 3, имзои HMAC мақоми дархост/посух (MITM/муҳофизати такрорӣ).
RBAC/ABAC/Re-BAC: нақш + кишвар + бренди + мақсад; ниқобҳои пешфарз.
Бисёр иҷорагир - схемаҳои изолятсия/калидҳо/квотаҳо.
Токенизатсияи идентификаторҳо; Манъи PII дар посухҳо.
Аудит: гузоришҳои тағйирнопазири дархост (WORM), 'trace _ id '/' actor '/' мақсад'.
Розигӣ/DSAR: филтрҳо дар бораи хусусиятҳои маркетинг; парчами "мавзӯъ тоза карда шудааст".
10) Антифроди RG/AML/Маҳдудият
Сиёсати RG: манъи додани нишондиҳандаҳои "хашмгин" барои сегментҳои дорои хавфи баланд; агрегатҳо бехатаранд.
AML/Antifraud: дастрасии маҳдуд ба KPI-ҳои ҳассос, минтақа аз рӯи нақш; нуқтаҳои ҷудогона барои тафтишот.
Фаҳмонидан: луғати тавзеҳоти KPI/сигналҳо барои дастгирӣ.
11) Мушоҳида ва SLO API
SLO: таъхири p95 (масалан, ≤ 300 мс барои зарбаҳои кэш; ≤ 2 с барои вазнин), дараҷаи муваффақият ≥ 99. 5%.
DQ: тару тоза/мукаммалӣ/якпорчагӣ; тамғакоғазҳо дар ҷавоб.
Истифода: QPS, hit-rate кэш, калидҳои гарм, хатогиҳои тасдиқкунӣ.
Огоҳиҳо: таназзули тару тоза, афзоиши 4xx/5xx, аномалияҳо мувофиқи KPI (сифрҳо/қуллаҳои ғайричашмдошт).
Пайгирӣ: 'trace _ id' ба охир то DWH/fichestore.
12) Версия ва мутобиқат
Роҳҳо: '/v1 ', '/v2'; бо равзанаи муҳоҷират фарсуда шавед.
Схемаҳо: 'schema _ version' дар ҷавоб; MAJOR → дастурҳои дутарафа, муҳоҷират.
Версияҳои KPI: дар ҷавоби 'kpi _ definitions' бо истинод дар директория; Пешгирии тағирёбии формулаи пинҳонӣ.
13) Хатогиҳо ва статусҳо
'400' validation (комбинатсияи метрикӣ/ченкунӣ/филтр вуҷуд надорад).
'401/403' authentication/autorization.
'409' 'номувофиқатии сиёсат.
'422' privacy/розигӣ.
квотаҳои '429'.
'5xx' platform нокомӣ (trace_id ва retry seq.).
json
{
"error":"VALIDATION_FAILED",
"message":"Unknown metric: ngrx",
"hint":"metrics allowed: ggr, net_revenue,...",
"trace_id":"..."
}14) Интегратсия ва интерфейсҳо
BI: моделҳои семантикии қаблан тавсифшуда, пайвасткунакҳо (Looker/Power BI/Tableau) → API ҳамчун манбаъ.
ML: нуқтаҳои ниҳоӣ барои воҳидҳои хусусият (нуқта дар вақт, бидуни PII).
Шарикон: калидҳои/квотаҳои маҳдуд, филтрҳои гео, ҳисоботҳо танҳо дар блокҳои маҷмӯӣ.
Webhook/Push: огоҳиҳо "лаҳзаи омода", "диапазони шикаста SLO/KPI".
15) Намунаҳои нуқтаҳои ниҳоӣ
15. 1 Даромад/Бозгашт
'POST/v2/metrics/даромад' → GGR/NGR, бурдҳо/бурдҳо, ки бо 'сана, бренд, кишвар, провайдер, бозӣ' чен карда мешаванд.
15. 2 Нигоҳдорӣ ва ҳалқаҳо
'POST/v2/metrics/нигоҳ доштан' → когорты D1/D7/D30, 'group _ by = [cohort _ week, бренд, кишвар]'.
15. 3 Пардохтҳо
'POST/v2/metrics/пардохтҳо' → пасандозҳо/бозпас гирифтан, чеки миёна, меъёри пардохт.
15. 4 Бозии масъул
'POST/v2/metrics/rg' → шумораи мудохилаҳо, таносуби хатари баланд, вақти реаксияи миёна.
15. 5 Антифрауд
'POST/v2/metrics/antifraud' → FPR/TPR, ҳолатҳо, талафот пешгирӣ карда шуданд.
16) Санҷиш ва сифат
Санҷишҳои шартномавӣ: enum/nullable/type, мувофиқати минтақаи асъор/вақт.
Санҷишҳои DQ: назорати диапазонҳо, якрангӣ ва якпорчагӣ.
Регрессия: муқоисаи v1/v2 оид ба таҳаммулпазирӣ.
Сарборӣ: профилҳои баландтарин (мусобиқаҳо/чорабиниҳои провайдер).
Амният: имзоҳо, такрори такрорӣ, дархостҳои номуайян, Zero-PII дар гузоришҳо.
17) Махфият бо нобаёнӣ
Агрегатҳо бо ҳадди ниҳоии "сабтҳои ҳадди ақали N" (k-беном).
Не идентификаторҳои хом; танҳо токенҳо/категорияҳо.
DSAR: API барои борфарорӣ/нест кардани токен тавассути ҳалқаи имтиёзнок.
18) Нишондиҳандаҳои муваффақият (API KPI .s)
Қабул: Таносуби ҳисоботҳо/виджетҳо, ки API-ро истифода мебаранд, на SQL-и мустақим.
Мувофиқат - номутобиқатӣ байни BI ва таҳаммулпазирӣ ≤ API.
SLO: риояи таъхир/муваффақият/тару тоза.
Амният: ҳолатҳои сифрии PII дар посухҳо/гузоришҳо.
Арзиш: меъёри хитои кэш, арзиши дархост,% пешгузаштаҳо.
19) RACI (мисол)
Маҳсулот/Таҳлил (A) - Таърифҳои KPI, талабот.
Платформаи маълумот (R) - татбиқ, кэш, SLA, мушоҳида.
Соҳибони домейн (R) - Манбаъҳо/Шартномаҳо.
Амният/DPO (A/R) - махфият, дастрасӣ, аудит.
SRE (R) - квотаҳо, автоскале, ҳодисаҳо.
Молия (C) семантикаи молиявии GGR/NGR/NET мебошад.
20) Харитаи роҳсозӣ
0-30 рӯз (MVP)
1. 3-5 KPI-ро интихоб кунед (GGR, амонатҳо, нигоҳдории D7).
2. Шартномаҳо ва семантикаи KPI-ро тавсиф кунед; Даргиронидани DQ/SLA.
3. Амалисозии '/v1 'дархости API + кэш + mTLS/HMAC.
4. Панелҳои SLO (ниҳонӣ/муваффақият/тару тоза), аудит/trace _ id.
30-90 рӯз
1. Мағозаҳои машҳури пешакӣ, кэши CDN.
2. Версия '/v2 ', дутарафа хондан, дастури муҳоҷират.
3. Содироти API бо боркуниҳои имзошуда ва WORM.
4. Интегратсия бо BI/ML; квотаҳо/иҷорагирон/гео-изоляторҳо.
3-6 моҳ
1. Пур кардани таксономия ва китобхонаи виҷет.
2. Маслиҳатҳои интеллектуалӣ/филтрҳои нопурра, линтерҳои дархостӣ.
3. Қайдҳои озодкунии худкор KPI, назорати таҳаммулпазирӣ v1/v2.
4. Доираи шарики беруна бо калидҳои маҳдуд ва сиёсати RG.
21) Анти-намунаҳо
Формулаи пинҳонии KPI бидуни версияи нав ва қайдҳои озод иваз карда мешавад.
Ба ҷои агрегатҳо/токенҳо PII/ашёи хомро баргардонед.
Набудани кэш/пререндерҳо → гарон ва суст.
Пайвастагии сахт ба пойгоҳи додаҳои мушаххас (абстраксияи қабат нест).
Рақамҳои номувофиқи TZ/FX →.
Не маҳдудият/квотаҳо → "DDOS худ".
22) Қолибҳо (барои истифода омодаанд)
22. 1 Сиёсати SLO API (порча)
yaml api: analytics. v2 slo:
p95_latency_ms: 300 success_rate: 0. 995 freshness_sec_max: 900 quotas:
per_key_qps: 50 burst: 200 privacy:
min_group_size: 25 pii_in_response: false22. 2 Кушодани API (порча)
yaml paths:
/v2/metrics/revenue:
post:
requestBody:
content:
application/json:
schema: {$ref: '#/components/schemas/RevenueQuery'}
responses:
'200': {description: 'OK', content: {application/json: {schema: {$ref:'#/components/schemas/RevenueResponse'}}}}
'422': {description:'Privacy/Consent violation'}22. 3 Рӯйхати назоратӣ
- Семантикаи KPI навсозӣ ва версия такмил дода шуд
- Шартнома/схема дар каталог; DQ/регрессия озмоиши сабз
- Калидҳои кэш/TTL, пешгузаштаҳо танзим карда шудаанд
- Ҳуҷҷатгузорӣ ва дархостҳои намунавӣ/посухҳо
- SLO ва огоҳиҳои квота дохил карда шудаанд
- Маҳдудиятҳои RG/AML санҷида шуданд
23) Қисматҳои марбут
Амалияи маълумот, аудит ва таҳрир, амният ва рамзгузорӣ, назорати дастрасӣ, токенизатсияи маълумот, сиёсати нигоҳдорӣ, пайдоиши маълумот ва роҳ, MLOps: истисмори моделӣ, этикаи маълумот.
Ҷамъ
Таҳлил ва ченакҳои API як қабати шартномавӣ, бехатар ва босуръати дастрасӣ ба маълумоти тиллоӣ ва KPI мебошанд. Он семантикаи ягона, версияҳои устувор, махфияти пешфарз ва иҷрои сатҳи маҳсулотро кафолат медиҳад - аз панелҳои дохилӣ то панелҳои шарикӣ ва ML.