API վերլուծաբաններ և մետրիկ

1) Ինչո՞ ւ է API առանձին շերտը

Միակ ճշմարտությունը KPI-ի համար 'բացառում ենք «SQL կենդանաբանական այգին»։

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

Անվտանգությունն ու համադրումը 'թունավորում, դիմակներ, գեո սահմանափակումներ, RG/AML ֆիլտրեր։

Մեծացումը 'քեշը, prerenders, CDN, կայուն պայմանագրեր։

2) Տաքսոնոմիա ՝ չափումներ, չափումներ, փաստեր,

Փաստերը 'տոկոսադրույքներ, հաղթանակներ, դեպոզիտներ, KYC իրադարձություններ, RG միջամտություններ։

Չափումներ ՝ ամսաթիվը/ժամանակը (օրացույցը), խաղը/պրովայդերը, բրենդը/երկիրը, ջրանցքը/dewis, խաղացողը (թոկեն)։

Մետրիկները ՝ GGR, NGR/NET, ARPPU, D1/D7/D30, ավանդների հաճախականությունը, FPR հակաֆրոդը, RG ռիսկը։

Միավորներ ՝ արժույթ (FX), ժամանակը (TZ), ծավալը/հաշվիչները (idempotent!)։

KPI-ի սեմանտիկան 'BI պայմանագրերում որոշումները, KPI-ի տարբերակները գրանցվում են։

3) API պայմանագրերը (Windows & BI Euracom)

Շեմա 'դաշտեր, տեսակներ, nullable, enum, միավորներ,։

Մետաքսի սեմանտիկան 'բանաձևը, աղբյուրները, ագրեգացիայի պատուհանները, ֆիլտրերը։

Համատեղելիությունը (SEMVER): MAJOR-ը կոտրում է, MINOR-ը ավելացնում է դաշտերը, PATCH-ը։

DQ/SLA 'թարմ, ամբողջական, կոնսիստենտալ, թույլատրություն և տարբերություններ։

Գաղտնիությունը '«pii: false», «tokenized: 108», մանրամասն արգելք։

Օրինակ (հատված)

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) Ճարտարապետություն

Query API (առցանց ագրեգացիան «gold «/խորանարդ/ֆիչեստորի վերևում)։

Precompert API (preenders գրաֆիկայի, materialized views)։

Events API (հոսքային հաշվիչներ/ազդանշաններ)։

Express API (ստորագրվել է, WORM-ը մրցույթի համար)։

Քաշ 'բազմաշերտ (in-memory no Redis no CDN), բանալին = hash հարցման + տարբերակը։

Համաձայնություն 'read-your-writes վերջնական ձայնագրությունների համար, SLA թարմ ագրեգատների համար։

5) Ինտերֆեյսը և հարցումները

5. 1 Ֆիլտրեր/ագրեգացիա/պատուհան

'www.ter': միջակայքը ("from/to 'UTC, timezone a.ru), երկրները, բրենդները, խաղերը, ալիքները, սարքերը։

'group _ by': Չափումներ։

'metr.ru': KPI ցուցակը։

`window`: `DAY|WEEK|MONTH|ROLLING_7D|ROLLING_28D`.

«currency»: «reporting 'native», FX ռազմավարություն' «eod 'intraday' txn»։

«sampling»: heavy հարցումների համար (միայն այնտեղ, որտեղ թույլատրելի է)։

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) Պագինացիա, սահմաններ, տեսակավորում

Պագինացիա ՝ «limit» (no. 10k), «cursor» (opaque), չափումների/ամսաթվերի տեսակավորումը։

Timeout/partial: մասնակի պատասխանները միայն KPI-ի համար։ ֆինանսները կամ P200, կամ P504։

Rate limits: գլոբալ/բանալին/tenantu; պատասխանը պարունակում է «X-Rance Limit-»։

7) Իդեմպոտենտալությունը և քեշը

Idempotent GET/POST-read (մարմնի հետ) «Idempotency-Key» -ի հետ։

Kash-բանալին = hash (պարամետրեր + սխեմայի + տարբերակը + դեր/tenant/geo)։

TTL: KPI կախվածությամբ (օրինակ ՝ «PT15M»), նոր սարքավորման ժամանակ։

8) Կոնսիստենտալությունը և ժամանակի արժույթը

Time-travel դրոշը հետադարձ կոդերի համար (տվյալների տարբերակները)։

Cut-off կանոնները (օր/շաբաթ)։

FX: Մենք արձանագրում ենք ռազմավարությունը, դասընթացի ամսաթիվը պատասխաններում։

Clock 'բոլոր թայմսթեմպերը' CSA-8601, TZ-ի հրահանգը պարտադիր է։

9) Անվտանգությունն ու գաղտնիությունը

mTLS/TLS1. 3, HMAC ստորագրությունը/պատասխանը (պաշտպանություն MITM/replay)։

RBAC/ABAC/ReBAC ՝ + երկիր + բրենդը + նպատակը; լռելյայն դիմակներ։

Բազմաբնույթ (multi-tenae) 'սխեմաների մեկուսացում/108/քվոտ։

Լուծողների տոկենիզացիա; PII-ի արգելքը պատասխաններում։

Աուդիտ 'անփոփոխ հարցումների լոգներ (WORM), «trace _ id »/« actor »/« purpose»։

Consent/DSAR 'մարքեթինգային ատրիբուտների ֆիլտրեր; դրոշը «wwww.ject erased» է։

10) RG/AML/Antifrod սահմանափակումներ

RG քաղաքականությունը 'արգելել «ագրեսիվ» ցուցանիշները high-risk հատվածների համար։ ագրեգատները անվտանգ են։

AML/Antifrod: Սահմանափակ հասանելիություն զգայուն KPI-ին, դերերի գոտիավորումը։ առանձին էնդպոինտներ հետաքննության համար։

Intainability: KPI/ազդանշաններ սապորտի համար։

11) Դիտարկումը և SLO API-ը

SLO: p95 latency (օրինակ, Քաշ-հիթերի համար 300 մզ, 362 ծանր), success-rate 3699։ 5%.
DQ 'թարմ/ամբողջական/ամբողջականություն; Նա պատասխանեց.

Usage: QPS, hit-rate, տաք բանալիներ, վալիդացիայի սխալներ։

Ալբերտները 'թարմության քայքայումը, 4xx/5xx-ի աճը, KPI-ի անոմալիաները (unexpected zeros/peaks)։

Tracing: «trace _ id» -ի միջոցով մինչև MSH/fichestor։

12) Տարբերակումը և համատեղելիությունը

Ճանապարհներ ՝ «/v1 », «/v2»; դեպրեքսը պատուհանի շարժիչով։

Սխեմաներ: պատասխանը; MAJOR www.d.read, միգրացիոն մրցույթներ։

KPI տարբերակները 'պատասխանելով' kpi _ intinitions ", հղում է խմբագրությանը; բանաձևերի թաքնված փոփոխությունների արգելք։

13) Սխալներ և արձաններ

'400' վալիդացիա (գոյություն չունեցող մետրիկ/չափում/ֆիլտրերի համադրություն)։

«401/403» վավերացում/հեղինակային։

տարբերակների անհամատեղելիությունը/քաղաքական։

«422» տերմինալի/consent խախտումը։

'429' քվոտաներ։

«5xx» պլատֆորմի ձախողումը (trace _ id և retry-2019)։ .

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

json
{
"error":"VALIDATION_FAILED",
"message":"Unknown metric: ngrx",
"hint":"metrics allowed: ggr, net_revenue,...",
"trace_id":"..."
}

14) Ինտերֆեյսներ և ինտերֆեյսներ

BI: նախապես semantic մոդելները, կոնեկտորները (Looker/WindoBI/Tableau) API-ն որպես աղբյուր։

ML: lightweight endpoinae-ի համար (PII)։

Գործընկերներ 'սահմանափակ բանալիներ/քվոտաներ, գեո ֆիլտրեր, հաշվետվություններ միայն ագրեգատ բլոկներով։

Webhook/Push: notionation «SLO/KPI միջակայքը»։

15) Ռեսուրսների էնդպոինտների օրինակներ

15. 1 Եկամուտ/եկամուտ

"POST/v2/metr.ru/revenue" www.GGR/NGR, տոկոսադրույքներ/շահումներ, չափումներով 'date, brand, country, provider, game "։

15. 2 Պահիր ու ձագեր

`POST /v2/metrics/retention` → когорты D1/D7/D30, `group_by=[cohort_week, brand, country]`.

15. 3 Վճարումներ

«POST/v2/metr.ru/payments» ռուսական դեպոզիտներ/եզրակացություններ, միջին ստուգում, chargeback rate։

15. 4 Responsible Gaming

«POST/v2/metr.ru/rg» -ը միջատների քանակը, high-risk մասնաբաժինը, արձագանքի միջին ժամանակը։

15. 5 Անտիֆրոդ

"POST/v2/metr.ru/antifraud 'no FPR/TPR, kass, կորուստ կանխված։

16) Փորձարկում և որակ

Պայմանագրային թեստեր ՝ enum/nullable/տիպ, արժույթների/ժամացույցի գոտիների համակարգումը։

DQ թեստերը 'միջակայքների, մոնոտոնիզմի և ամբողջականության վերահսկումը։

Reault: Համեմատություն v1/v2 տոլերանսների հետ։

Ծանրաբեռնվածություն 'պիկի ավելցուկ (ռոտր/պրովայդերական եբենտներ)։

Անվտանգությունը 'ստորագրություններ, հակա-replay, fuzzing հարցումներ, Zero-PII լոգարաններում։

17) Գաղտնիությունը լռելյայն է

Ագրեգատները «Նվազագույն N գրառումներ» (k-անունություն) շեմերով։

Ոչ մի ռուբ-լուծող; միայն հոսանքներ/կատեգորիաներ։

DSAR: APIA-ն, որպեսզի ստեղնաշարով դուրս գա/փաթեթ, արտոնյալ պայմանագրով։

18) Հաջողության մետրերը (KPI API)

Adoption: API-ն օգտագործող կոդերի/վիջետների մասնաբաժինը և ոչ թե ուղղակի SQL-ը։

Consistency-ը BI-ի և API-ի միջև տարբերությունն է։

SLO 'latency/success/freshness։

Տե՛ ս ՝ PII-ի զրոյական դեպքերը պատասխաններում/լոգարաններում։

Cost: hit-rate cash, հարցման արժեքը, preenders տոկոսը։

19) RACI (օրինակ)

Cort/Analytics (A) - KPI-ի որոշումները, կարիքները։

Platform (R) - ռուսական, քաշ, SLA, observability։

Domain Owners (R) - աղբյուրներ/պայմանագրեր։

System/DPO (A/R) - գաղտնիությունը, հասանելի, աուդիտներ։

MSE (R) - քվոտաներ, ավտոմեքենաներ, միջադեպեր։

Finance (C) - GGR/NGR/NET ֆինանսական սեմանտիկան։

20) Ճանապարհային քարտեզը

0-30 օր (MVP)

1. Ընտրել 3-5 KPI (GGR, դեպոզիտներ, D7)։

2. Նկարագրել պայմանագրերը և KPI-սեմանտիկան։ Միացրեք DQ/SLA։

3. Իրականացնել '/v1 'Query API + kash + mTSA/HMAC։

4. Dashbords SLO (latency/success/freshness), adit/trace _ id։

30-90 օր

1. Preenders (Precompox) հայտնի վիտրինը, CDN քեշը։

2. Տարբերակումը '/v2 ", drix-read, միգրացիոն դելդ։

3. API արտահանումը ստորագրված բեռնման և WORM-ի հետ։

4. Lentas BI/ML; քվոտաներ/տենանտներ/գեո մեկուսիչներ։

3-6 ամիս

1. Ամբողջական տաքսոնոմիա KPI և վիջեթների գրադարան։

2. Խելացի հուշումներ/ֆիլտրեր, հարցումների ոսպնյակներ։

3. Ավտոմատ Releant Notes KPI-ը, v1/v2 տոլերանսների վերահսկումը։

4. Արտաքին ավստրիական ֆորումը սահմանափակ լուծումներով և RG քաղաքական գործիչներով։

21) Anti-patterna

KPI բանաձևի թաքնված փոփոխությունը առանց նոր տարբերակի և ռելիզի-նոտի։

PII/հումքի արտադրանքը ագրեգատների/հոսանքների փոխարեն։

Քեշի/պրիրենդերների բացակայությունը թանկ է և դանդաղ։

Խիստ կապվածություն կոնկրետ BD-ի հետ (ոչ շերտի աբստրակցիան)։

Չհամաձայնեցված TZ/FX-ը բացատրում է չթողնված թվերը։

Չկա rate limits/քվոտ «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: false

22. 2 OpenAPI (հատված)

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/reresting կանաչ
• Քաշ-բանալիներ/TTL, preenders տրամադրված են
• Մոսկվան և հարցումների/պատասխանների օրինակները
• SLO-ի և քվոտաների մեջ ներառված են
• RG/AML սահմանափակումները ստուգված են

23) Կապված հատվածներ

International Ops-պրակտիկան, Audit-ը և տարբերությունը, անվտանգությունը և կոդավորումը, Հասանելիության վերահսկումը, Տվյալների ինդեքսավորումը, Պահեստավորման քաղաքականությունը, ծագումը և տվյալների ճանապարհը, MLOps-ը, մոդելների շահագործումը, տվյալների էթիկան։

Արդյունքը

API վերլուծաբաններն ու մետրիկը պայմանագրային, անվտանգ և արագ շերտ է «ոսկե» տվյալների և KPI-ի հասանելիության համար։ Այն երաշխավորում է միակ սեմանտիկան, կայուն տարբերակները, լռելյայն և արտադրողականությունը ապրանքի մակարդակի վրա 'ներքին տաշբորդներից մինչև 230 մգ և ML։