Amallar we Dolandyryş → Daşarky gurallar bilen integrasiýa

Daşarky gurallar bilen integrasiýa

1) Bu näme üçin zerur?

Islendik önüm platformasy diýen ýaly daşarky ekosistemalara bil baglaýar: töleg üpjün edijileri, KYC/AML, antifrod, email/SMS/push, analitika, oýun studiýalarynyň üpjün edijileri, BI, CDP, task-dolandyryjylar, marketing gurallary. Başarnykly dizaýn edilen integrasiýa öwrülişigi we aptaimi ýokarlandyrýar; sowatsyzlar - kaskad şowsuzlyklaryny, garaşylmadyk hasaplary we SLA üçin jerimeleri köpeldýärler.

• Üpjün edijileri çalt we ygtybarly birikdiriň.
• Işiň SLO-syny saklamak (goýum, stawka, netije, oýny başlamak).
• Kwotalary/çäkleri we çykdajylary dolandyrmak.
• Näsazlyk radiusyny we MTTR azalt.

2) Integrasiýalaryň taksonomiýasy

Sinhron API (REST/gRPC/GraphQL): derrew jogaplar, gizlinlik we elýeterlilik taýdan berk garaşlylyk.
Asinxron (webhook/event/queue): wakalary eltmek, tassyklamak, az wagt baglanyşygy.
SDK/müşderi kitaphanalary: giriş tizligi, ýöne görünmeýän endikler we "jadylar" töwekgelçiligi.
Batch/ETL/SFTP/faýl alyş-çalşygy: hasabatlar, reconciliation, gijeki ýüklemeler.
iFrame/Redirect/Hosted page: çalt, ýöne UX/Security gözegçiliginden az.
Hybrid: sinhron jaň + asenkron tassyklama (köplenç tölegler/KUS üçin).

3) Integrasiýany dolandyrmagyň modeli (governance)

Integrasiýa katalogy: eýesi, aragatnaşyklar, on-call, şertnamalar (OpenAPI/AsyncAPI), wersiýalar, gurşaw, açarlar/syrlar, kwotalar we nyrh.
SLO/OLA şertnamalary: ulanyja nämäni kepillendirýäris we üpjün edijiniň näme wada berýändigi; SLO, OLA/SLA-nyň aç-açan baglanyşygy.
Goýberiş geýtleri: consumer-driven contracts (CDC), gabat geliş synaglary, kanareýa goşulmalary, fiçeflaglar.
Maglumat syýasaty: PII, maliýe, GDPR/CCPA, ammar sebitleri, wendorlar bilen DPA.

4) Howpsuzlyk we syrlar

Syr saklamak: KMS/Secrets Manager, aýlaw, iň az hukuklar ýörelgesi, rol hasaplary boýunça elýeterlilik.
Gol we tassyklama: webhook üçin HMAC/JWS, serwer-serwer üçin mutual TLS.
IP allowlist/mTLS/WAF: Gelýän we çykýan kanallary goramak.
Token skope: Dar açar hukuklary, daşky gurşaw boýunça aýratyn açarlar.
Audit trail: gidýän ähli jaňlar we konfigurasiýalardaky üýtgeşmeler - audit-log.

5) Kwotalar, rate limits we ygtybarlylyk

Açyk rate-limit per-provider: 429/ban uçmazlyk üçin.
Bulkhead-izolýasiýa: her bir üpjün ediji üçin bölünip berlen akym/birikme howuzlary.
Gizlinlik býudjetiniň wagtlary: "zombi-kynçylyklary" döretmezlik üçin.
Backoff + jitterli retraýlar: diňe idempotent amallary/kodlary üçin.
Circuit breaker: çalt "ýykylmak" we pese gaçanda follbeke gaýdyp gelmek.
Queue + Outbox: möhüm amallar üçin - kepillendirilen eltip bermek we gaýtalamak.

providers:
psp_x:
timeout_ms: 200 rate_limit_rps: 1500 retries: 2 retry_on: [5xx, connect_error]
backoff: exponential jitter: true circuit_breaker:
error_rate_threshold: 0.05 window_s: 10 open_s: 30 pool: dedicated-psp-x (max_conns: 300)

6) Şertnamalar, wersiýa we laýyklyk

OpenAPI/AsyncAPI + SemVer: giňeltmek - backward-compatible; aýyrmak - deprekeýt döwri arkaly.
CDC synaglary: sarp ediji garaşýanlary düzedýär; gabat gelmeýän ýagdaýynda üpjün edijiniň goýberilmegi petiklenýär.
Shema Registry (wakalar): shemalaryň ewolýusiýasy (Euro/JSON-Shema); syýasat can-read-old/can-write-new.
Üýtgeşmelere gözegçilik etmek: change log, migrasiýa gidleri, köne wersiýanyň öçürilen senesi.

7) Çarşenbe we sandboks

Satyjyda Sandbox/Stage/Prod hökmany.
Synag maglumatlary: PII-like generatorlary, toslama kartoçkalar/resminamalar, synag gapjyklary.
Contract & integration tests: hakyky çäkli steýjiň garşysyna.
Golden-path & chaos-path: happy-case we negatiw ssenariler (timeouts/4xx/5xx/webhook-retries).

8) Synlamak we daşbordlar

Метрики per-integration: `outbound_rps`, `p95/p99`, `error_rate`, `retry_rate`, `circuit_open`, `cost_per_1k_calls`.
Webhook health: eltmegiň gijikdirilmegi, gaýtalanmalaryň göterimi, gol/tassyklama.
Relizleriň/fiçeflaglaryň wakalary: grafiklerdäki düşündirişler.
Garaşlylyk kartasy: kim üpjün edijä ýüz tutýar, nirede päsgelçilikler bar.

9) Wakalar we güýçlenmeler

Alertleriň baglanyşygy: eger üpjün ediji ýatan bolsa, ähli sarp edijileriň däl-de, integrasiýa eýesiniň sahypasy.
Awtodegradasiýa: "minimal re modeim" (ýeňil mazmun, ýönekeýleşdirilen KYC-flow, gaýtadan işlemek üçin nobatlar).
Feýlower/köp satyjy: PSP-X ⇄ PSP-Y, KYC-A ⇄ KYC-B; el we awtomatiki switch.
Runbook: wendordaky wakany nädip tassyklamaly, kwotalary köpeltmeli, alternatiw ýoly açmaly, yza süýşürmeli.

• Diagnostika: integrasiýa dashbord, wendoryň ýagdaýy, biziň loglerimiz 'trace _ id'.
• Hereketler: RPS azaltmak, breýkeri açmak, feýloweri açmak, fiçeflagy üýtgetmek.
• Aragatnaşyk: hadysanyň kanaly, işewürlik/sapport üçin täzelenmeleriň şablony.
• Yza gaýdyp gelmek/barlamak: p95/error-rate kadaly, nobat gaýtadan işlenildi, çykdajylar çäkde.

10) Çykdajylary dolandyrmak

CRM/CRA/CRS/çagyryşlar boýunça model: 'cost _ per _ 1k _ calls' we "üstünlik bahasy".
Kwotalar we "soft-cap": gorag bosagalary, duýduryşlar.
Kaching & deadup: gereksiz jaňlary azaltmak (idempotency keys).
Hasabatlar we reconciliation: Hasaby her gün biziň ýazgylarymyz bilen deňeşdirmek.

11) Webhooks bilen işlemek

Eltip bermek: 'at-least-once', eksponensial gijikdirme bilen gaýtalamak, 'event _ id' boýunça dedup.
Howpsuzlyk: goly (HMAC/JWS), taýtstemp, mTLS/allowlist.
Ygtybarlylyk: jogap 2xx diňe outbox/txn-a ýazylandan soň, ýogsam üpjün ediji retrait.
Idempotentlik: prosessorlar - idempotentler, saklamak "seen events".

12) Maglumatlar, gizlinlik we gabat gelmek

Data minimization: diňe zerur zatlary soraň.
PII/findanlar: bloglarda gizlemek, bellik etmek, şifrlemek.
Data residency: maglumatlaryň (sanawlaryň) saklanylýan we işlenilýän ýeri.
DPA/SCC: maglumatlary gaýtadan işlemek boýunça şertnamalar, subprosessorlar.
Aýyrmak/eksport etmek hukugy: API/amallar wendor tarapynda.

13) Anti-patternler

Ähli satyjylar üçin birikmeleriň umumy howuzy → head-of-line blocking.
Dar ýeriň wagtyna retraýlar → "retraýlaryň tupany".
Webhook goly/tassyklamasy ýok → frod we ýalan wakalar.
Aýlawsyz we aç-açan hukuksyz üýtgeýän gurşawdaky syrlar.
CDC-iň we şertnamalaryň wersiýasynyň ýoklugy → satyjy täzelenende köpçülikleýin ýykylmak.
Gözegçiliksiz SDK-da güýçli baglanyşyk → "gara guty".

14) Girizmegiň çek-sanawy

• Katalogdaky integrasiýa kartoçkasy: eýesi, SLA/OLA, nyrh, aragatnaşyklar, açarlar, shemalar.
• OpenAPI/AsyncAPI + CDC; stage synaglary, kanareýanyň açylmagy.
• Wagt, retrailer (idempotentlik!), breýker, bulkhead, rate-limit.
• Secrets: KMS/SM, aýlanyş, aýry-aýry açarlar per-env.
• Webhook: gol, dedup, gaýtadan eltip bermek, outbox.
• Daşbord we per-integration alertleri; çykyşlaryň düşündirişleri.
• Feýlower meýilnamasy (ikinji üpjün ediji/el switch), runbook we aragatnaşyklar.
• Çykdajy hasabatlary we reconciliation.
• DPA/complayens, maglumat syýasaty, audit-log.
• Esasy satyjylar üçin Game-days/chaos.

15) Integrasiýa hiliniň KPI

Kritiki amallar boýunça success rate (goýum/stawka/serişde).
p95/p99 gidýän jaňlar.
Retry storm count/aý (maksat → 0).
Üpjün edijileriň hadysalary boýunça MTTD/MTTR.
Cost per 1k calls/üstünlikli hereket.
CDC pass rate we integrasiýa hadysalary bolmazdan relizleriň paýy.
Webhook latency we gaýtalanma.

16) Çalt defoltlar

Wagt aýlawy = 70-80%; haýyşyň ýokarky wagty içerki mukdardan gysga.
Retrailer ≤ 2, diňe 5xx/tor, bilen backoff + jitter.
Circuit breaker: '10s', 'open = 30s', 'half-open' synaglary üçin ýalňyşlyklaryň% 5% -i.
Rate-limit per-provider, aýratyn birikmeler howzy.
Webhook: 'event _ id' -den soň tassyklamak.
"Iň az re modeime" çalt geçirmek üçin Ficheflag.

17) Alertleriň (pikirleriň) mysallary

ALERT ProviderErrorRateHigh
IF outbound_error_rate{provider="psp_x"} > 0.05 FOR 5m
LABELS {severity="critical", team="payments"}

ALERT ProviderLatencySLO
IF outbound_p99_latency_ms{provider="kyc_a"} > 300 FOR 10m
LABELS {severity="warning", team="risk"}

ALERT WebhookDeliveryDelayed
IF webhook_delivery_p95_s{provider="studio_y"} > 20 FOR 15m
LABELS {severity="warning", team="games"}

ALERT ProviderCostSpike
IF rate(provider_cost_usd_total[15m]) > 2 baseline_1w
LABELS {severity="info", team="finops"}

18) FAQ

Q: Üpjün edijiniň wagtlaýyn şowsuzlygyny biziň kynçylyklarymyzdan nädip tapawutlandyrmaly?
A: Simmetriýa serediň: üpjün edijiniň ähli müşderileri üçin ýalňyşlyklaryň köpelmegi, breýkeriň açylmagy, içerki ýalňyşlyklaryň/regressiýalaryň ýoklugy. Tracking & logs s 'peer. service 'kömek eder.

Q: Hemişe ikinji üpjün ediji gerekmi?
A: Möhüm ýollar üçin - hawa (PSP/KYC). Az tankytlaýanlar üçin - degradasiýa we nagt pul ýeterlik.

Q: Satyjynyň SDK ýa-da öz müşderisi?
A: SDK başlamagy çaltlaşdyrar, ýöne gözegçilik, wagt/retraut we pinning wersiýalaryny talap ediň. Ýogsam - HTTP/gRPC-iň üstündäki öz müşderisi.