Swintt - Baxış və inteqrasiya

Qısa baxış

Swintt iki əsas istiqaməti olan HTML5 slotlarının provayderidir: lakonik riyaziyyata malik «klassik» xətt və genişlənmiş mexanikaya malik «müasir» video slotlar (çoxluqlar, kolleksiyalar, respin/hold-and-win). Müştərilər asan, tez mobil WebView yükləyin. Standart inteqrasiya: SSO → başlanğıc-URL, BET/WIN/JACKPOT cüzdan kolbekləri, analitika və promo üçün JS körpü hadisələri.

Kimə uyğundur: məşhur klassik mövzulara ehtiyacı olan operatorlar/aqreqatorlar + proqnozlaşdırıla bilən inteqrasiya və mülayim TCO ilə müntəzəm video slot buraxılışları.

Portfel və istifadəçi təcrübəsi

Məzmun və mexanika

Video Slots: 5 × 3/6 × N; lines/ways; kaskadlar (titllərin hissələrinə); xN çoxluqları, expanding/stacked/walking wilds; respins/hold-and-win; simvolların yenilənməsi.
Klassik Slots: 3 × 3/5 × 3 «meyvə/yeddi/BAR» müasir riyaziyyat və sürətləndirilmiş oyun ilə.
Bonus rejimləri: frispins, pick-bonus, «pilləkənlər» çarpanlar, sticky-mexanika.
Buy Feature/Bonus Buy: Opsiyonel (title və yurisdiksiyasından asılı olaraq).
Jackpotlar: sabit/lokal/şəbəkə - qoşulma konfiqurasiyasına görə.

UX/UI

Sürətli FCP/TTI, kompakt assets, mobil sabit FPS.
Aydın ödəniş cədvəli, tur tarixi, Volatility/Hit Rate vitrin nişanları.
L10n: çoxdilli və multivalyutalı, yerli ədəd/tarix formatları, RG bildirişləri.

Texnologiya və performans

Müştəri: HTML5 (Canvas/WebGL), lazy-load, sprite/audio sıxılması, kritik resursların əvvəlcədən yüklənməsi.
Çatdırılma: CDN/edge-caching, idarə TTL, ehtiyat launch/CDN-domen (failover).
Şəbəkə: TLS 1. 2+, HTTP/2+; hədəf latency ən yaxın PoP <150-200 ms.
Mobile: CPU/batareyaya qənaət, şəbəkə itkisinə qarşı müqavimət.

Riyaziyyat, RTP və limitlər

RTP hovuzları: adətən bir neçə profil (≈ 96 %/ ≈ 94 %/ ≈ 92%); bazar və müqavilə üçün bild/kataloq səviyyəsində seçim.
Dəyişkənlik: aşağı/orta (klassik) yüksək (hold-and-win/çarpanlar).
Limitlər: min/max-stavka, avto-spinlər, seansların taymautları, gündüz/saat RG limitləri.
Valyutalar: minor units-da hesablaşma (tam ədədlə) yerli normalar üzrə düzgün dairələndirmə ilə.

İnteqrasiya modeli (yüksək səviyyəli)

1. Oyunçu → operator frontend → SSO/JWT (qısa TTL).
2. Operator/Aggregator API Swintt API: sessiya yaratmaq, 'launch _ url' almaq.
3. Müştəri (iFrame/yeni pəncərə) Game Server: oyun müştəri + JS-körpü (postMessage/SDK).
4. Operator API Wallet: BET (auth-debet), WIN/PAYOUT (kredit), JACKPOT_PAYOUT, nadir düzəlişlər.
5. BI/Reports: analitik hadisələr, raundların/əməliyyatların boşaldılması, reconciliation.

Ətraf mühit tələbləri

Təhlükəsizlik: IP-allowlist S2S, sorğuların/cavabların imzası, açarların/sirlərin rotasiyası, iFrame domenləri üçün ciddi CSP.
Etibarlılıq: eksponent fasilə ilə retralar, per player/session növbələri, açar açarları, sticky-routing.
Uyğunluq: aktual Chrome/Edge/Safari/Firefox, iOS/Android WebView.

Sessiyanın yaradılması və başlaması (psevdo-REST)

Sorğu:


POST /api/v1/sessions
Authorization: Bearer <operator-key>
{
"player_id": "u_57021",
"currency": "EUR",
"locale": "ru-RU",
"game_id": "swintt_<slug>",
"return_url": "https://operator. example. com/casino/return",
"limits": { "bet_min_minor": 100, "bet_max_minor": 400000 },
"flags": { "buy_feature": false, "autoplay": true },
"tags": { "vip_level": 1, "aff_id": "AFF-642" }
}

Cavab:


{
"session_id": "sess_ae73...",
"launch_url": "https://swintt. example/launch? sess=sess_ae73...",
"expires_in": 3600
}

Müştərinin başlanğıcı: iFrame/pəncərədə 'launch _ url' vasitəsilə; heartbeat/reauth tərəfindən dəstəklənir; hadisələr - JS körpüsü (ACK/NACK) vasitəsilə.

API Wallet və idempotentlik

Əsas axınlar

BET (auth-debet): dondurma/dərəcələrin silinməsi → cavab 'APPROVED/DECLINED' (balans/səbəb).
WIN/PAYOUT (kredit): uduşların/cekpotların hesablanması → yekun balansın qaytarılması.
ADJUST/REVOKE: müstəsna hallarda düzəlişlər (tam audit izi).

Çatdırılma zəmanətləri

Başlıq 'X-Idempotency-Key' (TTL ≥ 24 saat) və dedup operator tərəfindədir.
per player/session → zəmanətli sifariş növbələri.
Korrelyasiya 'round _ id '/' bet _ id '/' session _ id'; konfliktlər/təkrarlamalar üçün DLQ.

Ödəniş nümunəsi:


POST /wallet/payouts
Idempotency-Key: 9d1c-...
{
"player_id": "u_57021",
"round_id": "r_2025_11_02_19_45_33",
"amount_minor": 158000,
"currency": "EUR",
"reason": "round_win"
}

JS körpüsü və oyun hadisələri

Müştəri hadisələri → operator: 'GAME _ INIT', 'SPIN/BET', 'WIN', 'FEATURE _ TRIGGER', 'BONUS _ START/END', 'JACKPOT _ HIT', 'ERROR'.
Nəqliyyat: 'postMessage '/SDK, ACK/NACK təsdiqləri, ciddi' origin 'və nonce/imzaların yoxlanılması.
Tətbiq: analitika, CRM tetikləyiciləri, bannerlərin personallaşdırılması və kampaniyaların qoşulması.

Promo: frispins, missiyalar, turnirlər, jekpotlar

Free Rounds / Free Spins

Provider/Promo API və ya bonus mühərriki ilə sinxronizasiya vasitəsilə verin.
Parametrlər: fiks. bahis/denom, spin sayı, etibarlılıq müddəti, 'game _ id'.
Uçot: real/bonus-balansda uduşlar; operator/bazar qaydalarına görə veycer.

Missiyalar/tədbirlər

«N spin oyna», «X × ≥ qazan», «M dəfə fiçanı aktivləşdirin» - analitik hadisələr vasitəsilə irəliləyiş.

Turnirlər/Liderbordlar

Uduşların miqdarı, max-multiplier, spin sayı; hadisələr 'TOURNAMENT _ SCORE' analitikada.

Jackpotlar/Prize-drops

Çox səviyyəli hovuzlar (mini/major/mega), mystery/prize-drops; 'seed/cap', multivalyuta məhdudiyyətləri; ayrıca 'JACKPOT _ PAYOUT'.

Geo konfiqurasiyası və uyğunluğu

Geo kataloqu: başlıqların daxil edilməsi/xaric edilməsi, RTP profilinin seçilməsi, Buy Feature/risk oyunlarının bağlanması, yaş/regional məhdudiyyətlər.
Məsuliyyətli oyun: self-exclusion/time-auts/depozitlər/dərəcələr/vaxt limitləri, yerli RG bannerləri və cookie razılığı.
Data/PII: identifikatorların minimallaşdırılması və təxəllüsləşdirilməsi; log saxlama müddəti; tənzimləyicilərin tələblərinə görə ixrac.
Sertifikatlaşdırma: məqsədli yurisdiksiyalar altında sertifikatlı binaların/versiyaların istifadəsi.

Monitorinq, hesabat və SLA

Açar metriklər

Tech: uptime API/Launch/CDN, p95 cüzdan kolback, asset yükləmə sürəti, JS körpü səhv tezliyi.
Məhsul: 'Launch → First Spin', 'Spin → Bonus', ARP (B) U, saxlama, ROI kampaniyaları (frispins/missiyalar/turnirlər/damcılar).
Maliyyə: retrai/dedupların payı, məbləğlərin anomaliyaları, nightly-fərqlər.

İxrac/Reconciliation

Raundlar/əməliyyatlar/bonuslar/cekpotlar üzrə saatlıq/gündəlik yükləmələr (CSV/JSON/S3).
minor units 'round _ id/bet _ id/session _ id'; auto-alerts dublikat/pass/» lal» kolbeklər.

SLO/SLA təlimatları

API uptime ≥ 99. 95%, CDN assets ≥ 99. 9%; p95 kolbekov <500 ms (regiondaxili).
MTTR - hadisə-plan üzrə; prime time/kütləvi kampaniyalarda ayrı-ayrı SLO.

Təhlükəsizlik

Nəqliyyat: TLS 1. 2+, HSTS; iFrame domenləri üçün ciddi CSP.
Giriş: JWT/OAuth2 (müştəri), IP-allowlist/imza/lazım olduqda mTLS (S2S), sirlərin rotasiyası.
Data: log açıq PII qadağan; tokenization/hash 'player _ id'; operator at rest/backup şifrələmə.
Anti-frod: spin/bahis tezliyi anomaliyaları, çoxsaylı sessiyalar, şübhəli ASN/VPN; kvotalar/trottling/blok vərəqləri.

Ölçmə və uğursuzluq müqaviməti

Edge-cache: manifestlər/assetlər/lokalizasiyalar - TTL tərəfindən idarə olunan, buraxılışlar zamanı əlil olan əl.
Rate-limits: per player/session/API endpoint; «fırtına» hadisələrindən qorunma.
Graceful degradation: assets/effektlərin sadələşdirilməsi, hadisələrin tezliyinin azaldılması, «texniki iş» banner.
Failover: ehtiyat launch/CDN-domenlər; kontekstini itirmədən pere-issue token.

Çek vərəqləri

İnkişaf üçün

SSO tokenlərinin yaradılması/təsdiqlənməsi (qısa TTL, clock-skew qorunması).
API Wallet: idempotent debet/kredit, imza, növbələr, DLQ.
JS-bridge/SDK: hadisələr, ACK/NACK, təhlükəsiz 'origin'.
Promo API: frispins/turnirlər/missiyalar/damcılar; Veycerin uçotu.
İxrac: CSV/JSON/S3; sahələrin tamlığı (minor units, round/bet/session).

Başlanğıc üçün

Geo-kataloq, RTP profilləri, qadağan fiqurları söndürmək.
SLO monitorinqi (API/CDN/Wallet/JS) + alertlər.
Nightly reconciliation + duplications/pass.
RG/cookies banner, yerli tələblər.
Hadisə planı və status-səhifə.

FAQ (qısa)

iFrame başlatmaq? Bəli, razılaşdırılmış CSP/' X-Frame-Options 'ilə' launch _ url 'vasitəsilə.
Buy Feature mövcuddur? Title/bazar; konfiqurasiya ilə açılır.
Şəbəkə cekpotları varmı? Konfiqurasiyaya görə; ödənişlər - ayrı-ayrı 'JACKPOT _ PAYOUT'.
Frispins/turnirləri necə bağlamaq olar? Promo/Provider API + analitik hadisələr vasitəsilə.
RTP necə seçilir? Məqsədli yurisdiksiya və müqavilə altında bild/kataloq səviyyəsində.

Yekun

Swintt asan inteqrasiya və başa düşülən əməliyyat ilə «klassik» və müasir video slotları birləşdirir. Təsvir edilmiş nümunələri (SSO/başlanğıc-URL, Idempotent Wallet API, JS körpüsü, promosyon kampaniyaları, ciddi geo konfiqurasiyası, monitorinq və reconciliation) izləyən operator sabit məzmun iqtisadiyyatı, tənzimləyiciyə uyğunluq və pik yüklər üçün sabitlik əldə edir.