gRPC vs REST в iGaming

1) iGaming konteksti: näme üçin protokoly saýlamaly?

• hakyky wagt: koeffisiýentler, durmuş jedelleri, kupon/oýun statuslarynyň akymlary, oýunçynyň çäkleri, derrew blokirlemeler;
• geleşikler: goýum/aýyrmak, nyrhlary hasaplamak, bonuslar, KYC/AML, goldaw biletleri;
• hyzmatdaş/B2B integrasiýasy: oýun üpjün edijiler, töleg şlýuzlary, affiliatlar, düzgünleşdirijiler.

Teswirnama p99-latentlik, iň ýokary derejedäki durnuklylyk (oýunlar, finallar), integrasiýalaryň amatlylygy we ekspluatasiýa bahasy baglydyr.

2) Gysgaça: REST we gRPC näme

REST/HTTP/JSON: adam okalýan, ähliumumy. Brauzerler/ykjam SDK bilen ajaýyp işleýär, CDN tarapyndan kesilýär, jedel etmek aňsat.
gRPC (HTTP/2 + Protobuf): ikili şertnamalar, müşderileriň awtogenerasiýasy, uni/bi-directional streiming, multiplekslemek, berk shemalar. Tor hyzmaty - onuň elementi.

3) iGaming-de näme ýerlikli

gRPC - güýçli taraplary

Durmuş görnüşleri we treking: koeffisiýentleriň, oýun wakalarynyň, çäkleriň akymy (server streaming/bidi).
Içerki mikroservisler: töwekgelçilik hereketlendirijisi, kotirowka, antifrod skoring, balans/gapjyk - p99/CPU bildirilýän talaplar.
Gysga habarly uly RPS dolanyşygy (pes baýt bahasy, kiçi GC-pressure).
Toparlar bilen wersiýalaryň arasyndaky berk şertnamalar (backward-compat bilen Protobuf).

REST - güýçli taraplary

Jemgyýetçilik we hyzmatdaş API: ýönekeý integrasiýa (curl/Postman), gRPC-steki bolmadyk hyzmatdaşlar.
Brauzer fronty: ýerli, proksi ýok; / ETag/304/CDN kesiş goldawy.
Uzak ömürli çeşmeler: oýun kataloglary, profiller, hasabatlar, konfigurasiýalar.
Düzgünleşdiriji düşürmeler: JSON/CSV-gulpsyz gabat gelmek.

4) Gizlinlik we geçiriş ukyby

gRPC peýdaly ýüküň ululygy (Protobuf) we serializasiýa/deserializasiýa çykdajylary boýunça has tygşytly, gysga we ýygy-ýygydan çagyryşlarda ýeňiş gazanýar.
REST/JSON ýük ýüküne 30-200% goşýar, ýöne köpçülige açyk GET-de nagt pul we CDN arkaly ýeňýär.

Maslahat: DC içinde/hyzmatara - gRPC standart; hakyky wagtdan başga - REST.

5) Hakyky wagt: durmuş nyrhlary we kotirowkalar

• gRPC server streaming/bidi: täzelenmeler, backpressure, penjire gözegçiligi üçin hemişelik akym.
• gRPC-Web (Envoy arkaly) brauzer üçin, eger öň tarapda ikili teswirnama gerek bolsa.
• WebSocket/SSE + REST: gRPC-Web ekosistemasy laýyk gelmese ýa-da proksi bolmazdan arassa brauzer gerek bolsa.

Pattern: içerde - gRPC akymlary kotirowkadan API-şlýuzyna/edge; - Öň üçin WebSocket/SSE, CRUD üçin REST.

6) Ýol görkezijilik, eltip bermegiň tertibi we kepillikleri

REST: Şlýuzda POST üçin "Idempotency-Key", taýaut wagtynda gaýtadan ibermek; açar - Redis/DB c TTL.
gRPC: müşderiniň/balanslaýjynyň derejesinde retrailer + empotent usullary ('retriable _ status _ codes') we akym habarlarynda sequence/wersionirleme.
Nyrhlary hasaplamak üçin sinkde Inbox/Outbox + UPSERT ulanyň (de-duplikasiýa we tertip baradaky makalalara serediň) - teswirnamanyň özi iş täsiriniň kepilliklerini bermeýär.

7) Howpsuzlyk we gabat gelmek

Ulag: TLS/mTLS hem mesh, hem edge; gRPC-de mTLS (SPIFFE/SPIRE) hemme ýerde saklamak has aňsat.
Autentifikasiýa: iki wariant hem OAuth2/OIDC goldaýar (JWT in 'Authorization: Bearer'), gRPC üçin - meta-maglumatlar.
Gollar/NMAS: B2B REST integrasiýalarynda köplenç.
PII/loging: gRPC-iň binar payload tötänleýin "guýmak" has kyn, ýöne her niçigem bolsa maskany ulanyň.
Düzgünleşdirijiler köplenç adam ýüklerini talap edýärler - REST/JSON has amatly.

8) Gözegçilik etmek we peýdalanmak

Iki format hem OpenTelemetry: 'traceparent' (REST )/gRPC interseptorlary bilen ajaýyp işleýär.
gRPC baý statuslary/treýleri berýär; REST - tanyş HTTP kodlary we CDN/WAF gatlaklary.
Şlýuzda: rate limiting/quota, circuit breaker, outlier detection, fault injection - birmeňzeş elýeterlidir (Envoy/Kong/NGINX/Traefik).

9) Gabat gelmek we öň

Arassa brauzer gutudan gRPC gürlemeýär → gRPC-Web ýa-da REST/WS/SSE.
Jübi müşderileri (iOS/Android) - gRPC müşderileri elýeterlidir, ýöne SDK ululygy we gizlinlik syýasaty käwagt REST-e itergi berýär.

10) Garyşyk perimetriň binagärlik patternleri

10. 1 "Goşa fasad" strategiýasy

Içinde (gündogar-günbatar): gRPC.
Daşarky (north-south): REST + WS/SSE.
edge (Envoy) transkoding: bir arka, iki müşderi.

yaml
Envoy: REST ↔ gRPC transcoding (фрагмент)
typed_per_filter_config:
envoy.filters.http.grpc_json_transcoder:
"@type": type.googleapis.com/envoy.extensions.filters.http.grpc_json_transcoder.v3.GrpcJsonTranscoder proto_descriptor: "descriptors.pb"
services: ["betting.BetsService"]
print_options:
preserve_proto_field_names: true

10. 2 gRPC-Web

Brauzer → Envoy (gRPC-Web) → gRPC-hyzmaty. Live-widgetlar we administratiw UI üçin amatly.

11) API şertnamalary we ewolýusiýasy

Protobuf (gRPC)

Diňe habarlary giňeldiň (täze bellikler bilen meýdanlary goşuň), semantikany we görnüşleri üýtgetmäň.

proto syntax = "proto3";
package betting;

service BetsService {
rpc PlaceBet(PlaceBetRequest) returns (PlaceBetResponse);
rpc LiveOdds(EventsFilter) returns (stream OddsUpdate); // серверный стрим
}

message PlaceBetRequest {
string account_id = 1;
string event_id  = 2;
double stake   = 3;
string selection = 4;
string idempotency_key = 5;
}

OpenAPI (REST)

'/v1 'ýoly boýunça wersionirlemek, täze meýdanlar diňe opsiýaly.

yaml openapi: 3.0.3 info: { title: Bets API, version: "1.0" }
paths:
/v1/bets:
post:
operationId: placeBet parameters:
- in: header name: Idempotency-Key required: true schema: { type: string }
requestBody:
required: true content:
application/json:
schema:
$ref: '#/components/schemas/PlaceBetRequest'
responses:
'201': { description: Created }
components:
schemas:
PlaceBetRequest:
type: object required: [accountId, eventId, stake, selection]
properties:
accountId: { type: string }
eventId:  { type: string }
stake:   { type: number, format: double }
selection: { type: string }

12) iGaming halatlary: näme saýlamaly

13) Önümçilik nuanslary

Wagt/retrauslar

gRPC: 'per _ try _ timeout', çäklendirmek 'max _ attempts', retra diňe idempotent RPC üçin.
REST: şlýuzda eksponensial backoff, jitter, 429/5xx-syýasatlar.

Bedeniň/usulyň çäklendirilmegi

REST: Soragyň ululygyna çäklendirmeler, 'Content-Type' tassyklama.
gRPC: habarlaryň ululygyna çäklendirmeler, flow control.

Kesmek

REST: `Cache-Control`, `ETag`.
gRPC: programma/şlýuz derejesinde keş (unary üçin), akymlar üçin - snapshotlar/dilimler.

Syn ediliş

Hökmany: log korrelýasiýalary (request id), spanlar, marşrut/usul boýunça ýalňyşlyklaryň metrikleri, p50/p95/p99 paýlanyşy.

14) Anti-patternler

"Hemme zady gRPC-e täzeden ýazyň" we göni fronta bermäge synanyşyň - gRPC-Web/proxy bolmasa bu brauzeri döwer.
Jemgyýetçilik web-endpointleri diňe gRPC - hyzmatdaşlar ýykylar.
REST-polling arkaly livefidleri akdyrmak - toruň/bekendiň aşa ýüklenmegi we haýal sitatalar.
Indempotent däl amallary (stawkany/tölegi döretmek) müşderi derejesinde retra etmek.
/ sequence wersiýalarynyň ýerine wakalaryň tertibi üçin fiziki wagt bil bagla.

15) Teswirnamany saýlamagyň çek-sanawy

• Realtime traffigi ýa-da CRUD/hyzmatdaş?
• Müşderiler - brauzer/hyzmatdaşlar ýa-da mikroservisler/ykjam SDK?
• Akym gerek (server/bidi)?
• Perimetrde CDN/kesh gerek?
• p99 SLO we ýalňyşlyk býudjeti näme?
• Hasabat formatlaryna (JSON/CSV) düzgünleşdirijiniň talaplary barmy?
• Idempotentlik we babanyň meýilnamasy kesgitlenildi?
• API şlýuz/mesh bilen integrasiýa taýýar (mTLS, çäklendirmeler, ýaýlym)?
• Wersiýalaşdyrmak we gabat gelmek strategiýasy tassyklandy?
• Daşbordlar/alertler we "oýun-günüň" iň ýokary nokatlaryna synag pleýbuklary taýýar?

16) Kiçi oýunlar (Oýun günleri)

Oýun-pik: RPS live-feedleri iki esse köpeltmek → p99 baha bermek we habar ýitgileri (akymlary).
Üpjün edijiniň şowsuzlygy: akymyň pese gaçmagy - CB/outlier süzülmeli, öň - soňky snapshot bilen pese gaçmaly.
Şlýuz regressi: gRPC REST ýaýlymyny öçürmek - fallbackyň (WS/SSE) işleýändigini barlamak.
Tor gijikdirmeleri/WAN: RTT → wagtlaýynlygyň we backoffyň uýgunlaşmagyny barlamak üçin emeli usulda göteriň.
Uly jisimler (KYC): çäklendirmeleri/köp ýüklemeleri, jemlemeleri barlamak.

17) Netijeler

Klasteriň içinde: gRPC - öndürijilik, berk şertnamalar we akym üçin defolt.
Perimetrde: REST (we WS/SSE for real-time UI) - giň gabat gelmek üçin defolt.
Dünýäleri API şlýuzy (transkoding, limitler, autentifikasiýa) we service mesh (mTLS, trafik syýasaty) arkaly tikýäris.
Üstünlik - garyşyk arhitekturada aç-açan bölünişik bilen: içindäki akym/pes gizlinlik, daşarky amatlylyk we köptaraplylygy.