REST vs GraphQL в iGaming

TL; DR

REST - proqnozlaşdırıla bilən resurslar, sadə caching/CDN, güclü idempotent və webhucks. Ödənişlər, KYC/AML, PSP vebhukları, hesabatlar üçün fərqlidir.
GraphQL - müştəri tətbiqləri üçün «tam uyğun sahələr», aqreqasiya və BFF-lərin çevik nümunələri. Oyunlar kataloqu, personallaşdırma/tövsiyələr, lobodaşbordlar və operator konsolları üçün idealdır.
Combo-yanaşma: Kritik domenlər üçün Edge REST (ödənişlər, uyğunluq) + UI/widget 'lar və yığılmış oxunmalar üçün GraphQL-BFF.

1) Domenlər və tipik juzkeys

2) Performans və trafik

REST: aydın resurslar → asanlıqla 'GET' + 'ETag/Cache-Control' tərəfindən CDN-də önbelleğe alınır. Mənfi - mürəkkəb UI-lərdə «overfetch/underfetch».
GraphQL: mobil/yavaş şəbəkələrdə daha az trafik → düzgün sahə və rabitə tələb; N + 1 təhlükəsi və «bahalı» sorğular (cost-limitlər, dərinlik, complexity scoring).

• UI üçün - GraphQL-BFF daxili REST/gRPC üzərində.
• Xarici inteqrasiyalar və kritik əməliyyatlar üçün - incə DTO və server ekspandları ilə təmiz REST ('? include = balances, limits').

3) Cache və CDN

REST qazanır: 'GET' edge-də önbelleğe alınır; 'Vary '/' ETag' vasitəsilə dəyişkənlik.
GraphQL: müştəri/şlüz səviyyəsində cache (APQ, persisted queries, response cache per query hash). Açıq CDN üçün - daha çətin, lakin ağ siyahı ilə persisted queries mümkündür.

4) Müqavilələrin versiyası və təkamülü

REST: 'v1/v2' URI/başlığında; sahələr əlavə - icazə verilir, qırmaq - yeni versiyası. Sadə köhnəlmə siyasəti (deprecation).
GraphQL: v2 olmadan pozulmayan dəyişikliklər (sahə/növ əlavə); silinir - '@deprecated' və miqrasiya pəncərələri vasitəsilə. Sxem intizamı daha mürəkkəbdir, «schema registry» və linterlər lazımdır.

5) İdempotentlik, retraj, uyğunluq

REST: 'POST' üçün 'PUT '/' DELETE' və 'Idempotency-Key' başlığı ilə təbii idempotentlik (ödənişlər/refandlar). 'event _ id' və dedup ilə vebhukki.
GraphQL: mutasiyalar input aydın idempotentlik açarı tələb edir; tənqid üçün - REST/gRPC domen komandalarına mutasiyaları bükün.

6) Təhlükəsizlik və limitlər

• mTLS şlüz və backends arasında, OAuth2/OIDC (JWT, qısa TTL), ABAC tenant/rolları.

• marşrut/üsul, sadə rate/quotas nazik scopes.
• Imzalanmış vebhuk (HMAC + taymstamp), allow-list IP.

• Query complexity/depth limit, max nodes/aliases, rezolverlərdə timeout.
• Persisted/whitelisted queries ictimai müştərilər üçün.
• DataLoader/batching vs N + 1.
• Sahə/tip siyasəti (field-level authZ), seçicilərdə PII maskalanması.

7) Müşahidə və nəzarət

'trace _ id '/' span _ id' ilə korrelyasiya.
REST: end-point/metod üzrə metriklər (RPS, p95, 4xx/5xx).
GraphQL: əməliyyat/növü, rezolver vaxtı, «bahalı sahələr», xəta tezliyi sxemi.
Audit: kimin və hansı sahələrin oxuduğu/mutasiyaya uğradığı (KYC/AML/Responsible Gaming üçün vacibdir).

8) Real vaxt və hadisələr

PSP/oyun/antifrod hadisələri üçün REST webhucks (etibarlılıq, imza, retray).
GraphQL Subscriptions - canlı vidjetlər üçün əlverişlidir (balans, turnir, məsuliyyətli oyun limitləri). Kanalın ayrıca limitləri/avtorizasiyası tələb olunur.
Alternativ - SSE/WebSocket sadə kanallar üçün REST şlüzündə.

9) Multitenantlıq və regionlar

REST: marşrutlarla/domenlərlə təcrid, per-tenant kvotaları, region üzrə sadə marşrut.
GraphQL: bir endpoint - kontekstdə ciddi tenant scoping, sxem/rezolver səviyyəsində cross-tenant sahələrinin qadağan edilməsi lazımdır.
Geo-marşrutlaşdırma və data-residency: hər iki yanaşmada - gateway/policy vasitəsilə.

10) Matrix Solutions (sürətli seçim)

11) Anti-nümunələr

GraphQL üst-üstə: ödəniş mutasiyaları üçün bahalı və təhlükəsiz deyil.
Super-REST resursları ilə: UI-də çat-çat sorğuları.
GraphQL-də query limitlərinin olmaması: DDoS/« expensive query ».
DataLoader olmadan GraphQL: DB-də N + 1 uçqunu.
Mutasiyaların gizli idempotentliyi: ödənişlərdə/bonuslarda dubllar.
Bir qrafda/domendə ictimai və inzibati API qarışdırın.

12) iGaming üçün referans nümunəsi

Edge REST Gateway (WAF, OAuth2, rate/quotas, webhucks) ödəniş/komplayens domen üçün.
Cəbhələr üçün GraphQL-BFF: daxili REST/gRPC məlumatlarını yığır, field-authZ, complexity-limit, persisted queries daxil edir.
Service Mesh kapot altında: mTLS, trafik siyasəti, circuit-breaker.

13) Versiya/müqavilələrin sualları

REST

Müqavilə = OpenAPI + SDK Generation.
Versiyası: 'v1' → 'v2' ilə deprekasiya müddəti 6-12 ay.

GraphQL

Müqavilə = SDL + schema registry, linters (breaking change check).
Təkamül: '@deprecated', «sunset» təqvimi, diff sxemlərinin göndərilməsi.

14) Giriş çek siyahısı

• Müəyyən domenlər: REST (pul/komplayens) vs GraphQL (UI/aqreqasiya).
• Gateway: OAuth2/OIDC, mTLS, WAF, rate/quotas.
• REST: «Idempotency-Key», sabit statuslar, HMAC ilə vebhukları.
• GraphQL: persisted queries, complexity/depth, DataLoader, таймауты.
• Sahələrin auditi/loqosu, PII maskalanması, tenant örtüyü.
• Cache: REST üçün CDN, GraphQL üçün response cache/APQ.
• Müşahidə: p95 metrlər, error budget, «bahalı rezolverlər».
• Deprekasiya prosedurları (REST vN/GraphQL @deprecated).
• UAT: NFR yük testləri, «expensive query» hallarda, təkrarlanan mutasiyalar.

15) Miqrasiya yol xəritəsi (indi təmiz REST varsa)

1. UI ağır ssenariləri (kataloq, profil, daşbordlar) seçin.
2. GraphQL-BFF-ni mövcud REST/gRPC üzərində qaldırın; persisted queries daxil.
3. field-authZ və çətinlik limitləri çıxarın.
4. Frontları REST-də ödəniş dövrəsini buraxaraq GraphQL-ə addım-addım köçürün.
5. Ümumi schema registry və CI-yoxlama breaking-changes daxil edin.
6. N + 1 (DataLoader) optimallaşdırın, rezolver səviyyəsində cache əlavə edin.

16) NFT/SLO

REST: əlavə şlyuz latency ≤ 50-80 ms p95, 5xx şlyuz ≤ 0. 05%, vebhuk: çatdırılma p95 ≤ 3 s, təkrarlanan = 0.
GraphQL: p95 sorğu ≤ UI üçün 300-500 ms; max depth = 8–10; complexity budget per op; sxem xətası <0. 1%.

Xülasə

«REST və ya GraphQL» deyil, «hər ikisi - təyinatı üzrə». Güclü idempotentlik və vebhuk ilə sabit, proqnozlaşdırıla bilən REST ödənişləri və komplayens verin. Interfeys və analitikaya mürəkkəblik limitləri, sahə avtorizasiyası və caches ilə çevik GraphQL-BFF verin. Hər şeyi bir gateway, müşahidə və müqavilə intizamı ilə bağlayın - və sürətli UI, etibarlı pul və təhlükəsiz platforma təkamülü əldə edin.