Ինչպես միացնել պրովայդերներին API-ի միջոցով 'handshaik, հավաստագրում, sandbox

Հոդվածի ամբողջական տեքստը

💡 18+. Նյութը ինժեներական-կիրառական է, ոչ թե խաղի կոչը։ «Պրովայդերի» տակ հասկանում ենք RGS/71-ստուդիա/ջեքպոտ/ծառայություն; պլատֆորմի տակ 'PAM/դրամապանակ/դրամարկղ/բոնուսներ/RG։

1) Քարտեզագրություն ՝ 108-ից մինչև երկարաձգված։

Փուլերը

1. Պրեսսեյլ և Due Diligence: Jurprovers, geo/լիցենզիա, բովանդակության համատեղելիություն և RG քաղաքական։

2. Handshaik-ը և անվտանգությունը 'sandbox-հասանելի ֆորումը, բեկորների փոխանակումը (mTSA/HMAC), որը տեղադրված է Schema Registry-ում։

3. Techdisain: Մենք ապացուցում ենք հիբրիդային մոդելը (sessions/bets/settlements/events), idempotents, ռուսական սխալներ։

4. Sandbox ինտեգրումը 'դրամապանակի էմուլյատորներ/PSA/RG, թեստային խաղացողներ, «անձրևի» և դուբլի սցենարներ։

5. Սերտիֆիկացում 'պարտադիր թեստեր, կոդավորման ստորագրություն, բեռներ և քաոս-քեյսներ։

6. Staging/UAT 'ռազմական կիսագունդներ առանց իրական փողի, կանարական պաշտպանություն։

7. Go-International: Ընկերությունն է, դելֆիկ դրոշները, SLO-ը, հետպատերազմյան պատրաստվածությունը։

2) Handshaik 'վավերացում, հեղինակային իրավունքի, ուղու մասին

2. 1 Գաղտնիքների փոխանակում և սկուտերներ

MTSA (per brand/region) և/կամ OAuth2 Client Credentials-ը։

HMAC/EdDSA հարցման մարմնի ստորագրությունը (ավելացնում է non-repudiation)։

Скоупы: `sessions:write`, `bets:write`, `settlements:write`, `events:publish`.

2. 2 Պարտադիր վերնագրեր

«X-Trace-Id» - ուղու միջով։

`X-Brand-Id`, `X-Region`, `X-Provider-Id`.

«X-Idempotency-Key» - բոլոր write վիրահատությունների համար։

2. 3 Health-ստուգում (մինչև կոդի)


GET /health
→ 200 {"status":"ok","version":"1. 7. 2","time":"2025-10-23T10:00:00Z"}

3) Sandbox: Ի՞ նչ կա և ինչպես օգտագործել դրանք։

Շրջապատի կազմը

Դրամապանակի էմուլյատոր ('/wallet/debit	credit	rollback ') համադրությամբ և ձերբակալություններով։
RG-huki ('/rg/www.k ',' rg. limit. hit ') և թեստային պրոֆիլներ (ինքնաբուխ/լիմիտներ)։
Ֆալշ-ագրեգատոր/ջեքպոտ 2019/ձգողական համար։
Fake KYC/AML պատասխանները (allow/deny/pending)։
Իրադարձությունների շարքը (Kafka/Pulsar) թեստ կացիններով և Schema Registry-ով։

Ներդաշնակությունը իրականության հետ

Սխեմաների նման տարբերակները և rate limits, ինչպես նաև վաճառքում։

Tim-sku, առաքման դուբլներ, out-of-order-ը ներկառուցված են էմուլյացիայի կոճակներով։

Թեստային խաղացողների/արժույթների հավաքածու


p_demo_1 (EUR), p_demo_2 (USD), p_blocked_rg (denied), p_low_balance

4) Ռեսուրսային մոդելը և նվազագույն պայմանագիրը

4. 1 Նստաշրջանի ստեղծում


POST /v1/sessions
{
"player_id":"p_demo_1",  "game_id":"studio:slot_forge_02",  "currency":"EUR",  "locale":"de-DE"
}
→ 201 {"session_id":"s_456","expires_at":"2025-10-23T19:10:00Z"}

4. 2 Տոկոսադրույքի հեղինակային իրավունքը (hold)


POST /v1/bets/authorize
Headers: X-Idempotency-Key: bet_r_8c12_1
{
"session_id":"s_456",  "bet_id":"b_001",  "round_id":"r_8c12",  "amount":{"amount":2. 00,"currency":"EUR"}
}
→ 200 {"status":"authorized","hold_id":"h_zz1"}

4. 3 Settlment (մրցույթի արդյունքը)


POST /v1/bets/settle
Headers: X-Idempotency-Key: settle_r_8c12_1
{
"bet_id":"b_001",  "round_id":"r_8c12",  "win":{"amount":14. 60,"currency":"EUR"},  "bonus_state":{"in_bonus":true,"freespins_left":7}
}
→ 200 {"status":"credited","settlement_id":"st_77"}

4. 4 Սխալ (միասնական սխալը)


409
{"code":"DUPLICATE","message":"Bet already authorized","retryable":false,"trace_id":"tr_a1b2"}

5) Իրադարձություններ և սխեմաներ. Առանց դրա չես անցնի սերտիֆիկացում

Հիմնական կացինները

`session. started	ended`, `bet. authorized	settled	rolled_back`, `bonus. issued	consumed`, `wager. progress. updated`, `wallet. debit.`, `wallet. credit.`, `rg. limit. hit`, `rg. reality_check`.

Avro/JSON Schema (հատված 'bet. settled`):

json
{
"event_type":"bet. settled",  "schema_version":"1. 2. 0",  "event_id":"uuid",  "occurred_at":"2025-10-23T16:21:05Z",  "tenant_id":"brand-7",  "region":"EU",  "player_id":"p_demo_1",  "trace_id":"tr_a1b2",  "payload":{
"round_id":"r_8c12",   "bet":{"amount":1. 00,"currency":"EUR"},   "win":{"amount":14. 60,"currency":"EUR"},   "in_bonus":true
},  "idempotency_key":"bet_r_8c12_1"
}

Կանոնները ՝ backward-compatible էվոլյուցիա, «կրկնօրինակման և ուշ իրադարձությունների» թեստը, «tenrone _ id/player _ id» խմբակցությունը։

6) Սերտիֆիկացիան բացատրում է. Ի՞ նչ են ստուգում

6. 1 Ֆունկցիոնալ սցենարներ (նվազագույն)

«Authorize/settle» հարցման խոհարարը նույն «X-Idempotency-Key» -ի հետ նույն պատասխանն է։

Out-of-order: եկավ «settle» առանց «authorize» -ի ճիշտ մերժումը։
Rollback շղթաները դրամապանակի/ցանցի անկման ժամանակ։
RG ոտքերը 'ինքնաբուխ/սահմանաչափը/ժամանակը նախատեսվում է արգելել դրույքաչափը։
Բոնուս/waiger 'խաղի տեսակի ներդրումը, max bet, dedline։

6. 2 Ծանրաբեռնվածություն

p95 'bet/settle 's (օրինակ ՝ <200-300 ms ")," փոթորիկների "բացակայությունը։

Իրադարձությունների հոսքերը հասնում են BI 355-ին։

6. 3 Հաոս քեյսներ

Առաքման դուբլի, www.box/CDC-ի ձգձգումը, «շեղեց» տարածքը, մասնակի ցանցաթաղանթը։

6. 4 Փաստաթղթեր արդյունքներից

Թեստերի արձանագրությունը թայմկոդների/trace-id-ի հետ։

SLO զեկույցը (latency/error/lag)։
Անվտանգության (բանալիներ, ռոտացիաներ, հասանելի, Vox/HSM)։

7) Տարբերությունը և իրականացումը

HTTP: մարմնի մեջ։

SemVer: minor - oporatic դաշտերի ավելացում; major - միայն նոր նախածանցով «/v2/»։

Deprecation headers: «Deprecation», «Sunset», dashbord- ում օգտագործման հայելի։

Ֆիչ դրոշները 'իրադարձությունների «կրկնակի նամակ» («v1» և «v2») անցումային ժամանակահատվածում։

8) Անվտանգություն և համապատասխանություն

MTSA + ստորագրություններ S2S, կարճ հոսանքներ, սահմանափակ կատակներ։

Zero-trust: ցանցային քաղաքականություններ, per-brand/region բանալիներ։

Residency & PII 'պահպանումը և լոգները տարածաշրջանում։ RFC/դիմակավորում։

WORM-աուդիտ 'սահմանների փոփոխությունները, RTP-2019, ջեքպոտ-դելիգները։
RG/AML 'սինխրոն ստոպային ազդանշաններ տոկոսադրույքի վրա/108; SAR/STR հաշվետվությունը։

9) Անցում դեպի անցում. Ստուգման ցուցակ գործարկման համար

Մինչև ներառելը

Sandbox-գաղտնիքների լուծումը բացատրվում է նախկին բանալիների կողմից։

Ներառված են p95/p99, error-rate, queue-lag, settle-lag։
Alerta SLO: breach latency/error/lag, «DUPLICATE/IDEMPOTENCY _ MISMATCH»։
DR պլանը ՝ RPO 355 րոպե, RTO 3530 րոպե; «կարմիր կոճակը» նոր նստաշրջանների կանգառ է։

Կանարեյկա

Լսարանի/խաղերի/գեոյի 1-5 տոկոսը; ավտոմատ rollback sLO-ի խախտման ժամանակ։

Փոստ-2424-72 ժամ, սառցադաշտի/զեկույցների հասակը։

10) Anti-patterns (կարմիր դրոշներ)

Իրադարձությունների հրապարակումը շրջանցելով www.box/CDC-ն։

«X-Idempotency-Key» -ի բացակայությունը write վիրահատություններում։
Հավասարակշռությունների/ցանցաթաղանթի ձեռքով ուղղությունները BD-ում։
Միասնական բանալիներ մի քանի բրենդների/տարածաշրջանների վրա։
BI-ը և կարգավորող զեկույցները OLTP-մարտական BD-ի վերևում։
Զրոյական քայքայումը 'պրովայդերի անկումը դրամապանակ/պլատֆորմ է։

11) Չեկ թերթերը

Պրովայդերի համար

Ես գնում եմ "X-Trace-Id 'և" X-Idempotency-Key "միշտ։
Ես նույն բանալին եմ աջակցում առանց կողմնակի էֆեկտների։
Հանրային իրադարձություններ Registry-ի սխեմաների համաձայն. պահպանում եմ «schema _ version»։
Իրականացվել են backoff-ից և deduplication-ից։
RG ոտքերը և բոնուսային սահմանափակումները պահպանվում են real-time-ում։
Հասանելի և գաղտնիքները 'per brand/region, լուծումը տրամադրված է։

Պլատֆորմի համար

Disbox/CDC բոլոր դրամական ճանապարհների վրա; ուղղությունը end-to-end։
SLO-dashbords: p95/99, error-rate, queue-lag, settle-lag։
Deprecation/Sunset-գործընթացը, երկու նամակագրությունը։
DR/xaoc-ուսմունքները, կառավարումը և հետմորտեմները։
Քայքայման ռեժիմները '«new sessions», պրոմո/ջեքպոտի անջատումը։

12) «108» պլեյբուկի օրինակը (TL; DR)

1. Ստորագրել NDA/պայմանագիրը պլանավորվում է sandbox-հասանելի և սխեմաներ տալ։

2. Փոխանակել mTSA/HMAC հավաստագրեր; ավելացրեք 'provider _ id'։

3. Համաձայնեցնել նվազագույն էնդպոինտները '«sessions», «bets/authorize», «bets/settle», «rollback»։

4. Միանալ Sandbox-շինին և Registry-ին։ քնել ֆունկցիոնալ/քաոս-քեյսներ։

5. Սերտիֆիկացման արձանագրություն 'լոգներ, trace-id, SLO զեկույցը։

6. Անցեք բանալիները, միացրեք կանարեյկան, դիտեք SLO-ն։

7. Ամրագրել փոստի-ստացիոնար մետրերը և «դասերը» չանգելոգում։

Պրովայդերի հաջողակ միացումը ոչ միայն API-ն է, այլ կառավարվող գործընթացը 'անվտանգ handshaik, իրատեսական sandbox, խիստ սերտիֆիկացում, դիտարկելի և հստակ կանոններ։ Հետևելով նկարագրված invariants (idempotention, www.box/CDC, RG/AML ոտքերը, SLO և DR), դուք արագացնում եք վճարումները, խուսափում եք կանխամտածված վճարներից և ստանում եք կանխատեսելի օրինագծեր 'առանց անակնկալ խաղացողների, կարգավորողների և բիզնեսի համար։