RubyPlay - baxış və inteqrasiya
Qısa baxış
RubyPlay - HTML5-slot studiyası. Məşhur cetvellər arasında «Immortal Ways» və çox səviyyəli cekpotlu mahnılar yer alır. Müştərilər asan, tez mobil WebView başlayın. İnteqrasiya tipik: SSO → başlanğıc-URL, BET/WIN/JACKPOT cüzdan, analitika/CRM/promo üçün JS körpü hadisələri.
Kimə uyğundur: «seriyalı» məzmun təqdim edən vitrinə ehtiyacı olan operatorlar/aqreqatorlar, proqnozlaşdırıla bilən istismar, yüksək buraxılış rotasiyası və hazır promo çəngəllər (missiyalar, turnirlər, damcılar).
Portfel və istifadəçi təcrübəsi
Məzmun və mexanika
Video Slots: 5 × 3/6 × N; lines/ways, kaskadlar (oyun hissələri üzrə), xN çoxluqları, expanding/stacked/walking wilds.
Collect/Hold-and-Win/Respin: sikkə/fix mükafatları, təkrarlanan spins, mini/major/mega səviyyələri.
Serial Ficks (məsələn, Immortal Ways): əlavə sütunlar/simvol yolları, gücləndirilmiş kolleksiyalar və irəliləyişlər.
Bonus rejimləri: xüsusi simvollar/baraban yeniləmələri, pick-bonus, çarpanların «pilləkənləri» olan frispinlər.
Buy Feature/Bonus Buy: Title və yurisdiksiya ilə daxil edilir.
Jackpotlar: sabit/lokal/şəbəkə - qoşulma konfiqurasiyasına görə.
UX/UI
HTML5-müştəri: sürətli FCP/TTI, qənaət assets, mobil sabit FPS.
Oxunaqlı ödəniş cədvəlləri, vizual tərəqqi/kolleksiya sayğacları, tur tarixi.
L10n: çoxdilli/multivalyutalı, yerli ədəd/tarix formatları və RG mesajları.
Texnologiya və performans
Müştəri: Canvas/WebGL, lazy-load assets, kompres sprite/audio, 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üldükdən sonra düzgün resume; qısamüddətli qırılmalara qarşı müqavimət.
Riyaziyyat, RTP və limitlər
RTP hovuzları: adətən ≈ 96 %/ ≈ 94 %/ ≈ 92% (və digər variantlar) - bazar və müqavilə üçün bild/kataloq səviyyəsində seçim.
Dəyişkənlik: aşağı/orta (klassik) yüksək (collect/hold-and-win/çarpanlar). Volatility/Hit Rate nişanları vitrində tövsiyə olunur.
Limitlər: min/max dərəcəsi, avto spin məhdudiyyətləri, seansların taymautları və yurisdiksiya üzrə RG limitləri.
Valyutalar: minor units-da hesablama (tam say), yerli normalara uyğun düzgün dairələr.
İnteqrasiya modeli (yüksək səviyyəli)
1. Oyunçu → operator frontend → SSO/JWT (qısa TTL).
2. Operator/Aggregator API, RubyPlay 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_74251",
"currency": "EUR",
"locale": "ru-RU",
"game_id": "rubyplay_<slug>" ,//series/slot: ImmortalWays _, etc.
"return_url": "https://operator. example. com/casino/return",
"limits": { "bet_min_minor": 100, "bet_max_minor": 500000 },
"flags": { "buy_feature": false, "autoplay": true },
"tags": { "vip_level": 1, "aff_id": "AFF-821" }
}
Cavab:
{
"session_id": "sess_b93f...",
"launch_url": "https://rp. example. com/launch? sess=sess_b93f...",
"expires_in": 3600
}
Müştərinin başlanğıcı: iFrame/pəncərədə 'launch _ url'; 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): → 'APPROVED/DECLINED' dərəcəsinin dondurulması/silinməsi (+ balans/səbəb).
WIN/PAYOUT (kredit): uduşların/cekpotların hesablanması → yekun balansın qaytarılması.
ADJUST/REVOKE: müstəsna hallarda tam audit izi ilə düzəlişlər.
Çatdırılma zəmanətləri
Başlıq 'X-Idempotency-Key' (TTL ≥ 24 saat), dedup operator tərəfindədir.
per player/session → zəmanətli sıra; Münaqişələr üçün DLQ.
Korrelyasiya 'round _ id '/' bet _ id '/' session _ id'.
POST /wallet/payouts
Idempotency-Key: 12f0-...
{
"player_id": "u_74251",
"round_id": "r_2025_11_02_20_06_11",
"amount_minor": 167000,
"currency": "EUR",
"reason": "round_win"
}
JS körpüsü və oyun hadisələri
Клиент → оператор: `GAME_INIT`, `SPIN/BET`, `WIN`, `FEATURE_TRIGGER`, `BONUS_START/END`, `COLLECT`, `RESPIN`, `JACKPOT_HIT`, `ERROR`.
Nəqliyyat: 'postMessage '/SDK, ACK/NACK təsdiqləri, ciddi yoxlama' origin 'və imza/nonce.
Təyinatı: analitika, CRM tetikləyiciləri, kampaniyaların qoşulması (free rounds/missiyalar/turnirlər/damcılar), dinamik bannerlər.
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; veycer - operator/bazar qaydalarına əsasən.
Missiyalar/tədbirlər
«N spins oyna», «≥ X × oyna», «fiçanı M dəfə aktiv et», «K simvolları topla» - 'MISSION _ PROGRESS' hadisələri.
Turnirlər/Liderbordlar
Metriklər: uduşların cəmi, max-multiplier, spin/kolleksiyaların sayı; hadisə 'TOURNAMENT _ SCORE'.
Jackpotlar/Prize-drops
Multi-tier (mini/major/mega), mystery/prize-drops; 'seed/cap' parametrləri, multivalyuta məhdudiyyətləri.
Ayrı kollbek 'JACKPOT _ PAYOUT' idempotentlik və hovuz rekvizitləri ilə.
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/limitlər, 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əbi ilə ixrac.
Sertifikatlaşdırma: məqsədli yurisdiksiyalar üçün sertifikatlı binaların istifadəsi; phich hissəsi bazar ilə məhdudlaşa bilər.
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 domen altında 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/collect-event 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/missiyalar/turnirlər/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ı/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 və bazar; konfiqurasiya ilə açılır.
Şəbəkə cekpotları varmı? Konfiqurasiyaya görə; ödənişlər ayrı-ayrılıqda gəlir 'JACKPOT _ PAYOUT'.
Frispins/turnirləri necə bağlamaq olar? Promo/Provider API + analitik hadisələr vasitəsilə.
RTP necə seçilir? Konkret yurisdiksiya və müqavilə üzrə bild/kataloq səviyyəsində.
Yekun
RubyPlay slot dizaynına seriyalı yanaşmanı və davamlı vitrin və rahat promo ssenariləri verən «yığıcı» iqtisadiyyatı 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ərək, operator gözlənilən məzmun iqtisadiyyatını, tənzimləyiciyə uyğunluğu və pik yüklər üçün sabitliyi əldə edir.