Platipus - Genel Bakış ve Entegrasyon

Genel bakış

Platipus, hafif istemcilere ve düzenli sürümlere önem veren bir HTML5 slot sağlayıcısıdır. Portföy, klasik 3 × 3/5 × 3 ve çarpanlar, respin/hold-and-win, genişleyen vahşi ve freespins ile modern video yuvaları içerir. Tipik entegrasyon: SSO - başlatma URL'si, BET/WIN/JACKPOT cüzdanı, analitik, CRM ve promosyon için JS köprüsü etkinlikleri.

Kim uyuyor: "Hızlı" HTML5 oyunlarının öngörülebilir bir kataloğuna ihtiyaç duyan operatörler/toplayıcılar, karmaşık özelleştirme olmadan promo'nun basit çalışması ve esnekliği.

Portföy ve kullanıcı deneyimi

İçerik ve Mekanik

Video yuvaları: 5 × 3/6 × N; Çizgiler/yollar, bazen basamaklar; xN çarpanları; genişleyen/yığılmış/yürüyen vahşiler; Respin/hold-and-win; Koleksiyon sembolleri ve yükseltmeleri.
Klasik slotlar: Güncellenmiş matematik ve hızlandırılmış gamelup ile 3 × 3 "meyve/yedili/BAR".
Bonus modları: özel semboller/çarpanlar, pick-bonus, risk oynama/ikiye katlama (yetki alanı tarafından izin verilirse) içeren freespins.
Bonus Satın Alma/Özellik Satın Alma: Isteğe bağlı, başlık ve pazara göre dahil.
Jackpots: fix/local/network - bağlantı yapılandırmasına göre.

UX/UI

HTML5 istemcileri: hızlı başlangıç, kompakt varlıklar, mobil WebViews'de istikrarlı FPS.
Okunabilir ödeme tabloları, ilerleme göstergeleri, yuvarlak geçmiş.
L10n: çok dilli/çok para birimi, yerel sayı/tarih biçimleri ve Sorumlu Oyun mesajları.

Teknoloji ve performans

İstemci: Canvas/WebGL, lazy-load varlıkları, sprite/ses sıkıştırma, kritik kaynak ön yüklemesi.
Teslim: CDN/kenar önbelleğe alma, TTL yönetilen, yük devretme etki alanları.
Ağ: TLS 1. 2 +, HTTP/2 +; En yakın PoP <150-200 ms için hedef gecikme.
Mobil: katlandıktan sonra doğru özgeçmiş, kısa süreli ağ kopmalarına karşı direnç.

Matematik, RTP ve Limitler

RTP havuzları: genellikle % ≈96/% ≈94/% ≈92 (ve diğer seçenekler) - pazar ve sözleşme için yapı/katalog düzeyinde seçilir.
Volatilite: Düşük/orta (klasik) ila yüksek (tut ve kazan/çarpanlar). Volatilite/Hit Rate ekran rozetleri önerilir.
Limitler: min/max bahis, otomatik dönüşler, oturum zaman aşımları; Bazı oyunlar için - bonus özelliklerinin maliyeti sınırları.
Para birimleri: doğru yuvarlama ile küçük birimlerde (tam sayı) hesaplama.

Entegrasyon modeli (üst düzey)

1. Oyuncu - operatörün önü - SSO/JWT (kısa TTL).
2. Operatör/Toplayıcı API ↔ Platipus API: oturum oluşturma, 'launch _ url' yayınlama.
3. İstemci (iFrame/yeni pencere) ↔ Oyun Sunucusu: oyun istemcisi + JS köprüsü (postMessage/SDK).
4. Cüzdan operatörü API: BET (auth-debit), WIN/PAYOUT (kredi), JACKPOT_PAYOUT, nadir ayarlamalar.
5. BI/Raporlar: analitik olaylar, yuvarlak/işlem yüklemeleri, saatlik/günlük mutabakat.

Çevresel gereksinimler

Güvenlik: S2S için IP-allowlist, istek/yanıt imzalama, anahtar/gizli rotasyon, iFrame etki alanları için sıkı CSP.
Güvenilirlik: Oyuncu/oturum başına kuyruklar, üstel duraklama, anahtar kilitlenme, yapışkan yönlendirme ile geri dönüşler.
Uyumluluk: Mevcut Chrome/Edge/Safari/Firefox, iOS/Android WebView.

Bir oturum oluşturun ve başlatın (sözde REST)

İstek:


POST /api/v1/sessions
Authorization: Bearer <operator-key>
{
"player_id": "u_80541",
"currency": "EUR",
"locale": "ru-RU",
"game_id": "platipus_<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-458" }
}

Cevap:


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

İstemci başlatma: iFrame/pencerede 'launch _ url'; Kalp atışı/reauth desteklenir; JS köprüsü boyunca olaylar (ACK/NACK).

Cüzdan API ve idempotency

Akışlar

BET (auth-debit): oran donması/silinmesi - 'ONAYLANDI/REDDEDILDI' (denge/sebep).
WIN/PAYOUT (credit): Win/jackpot kredisi - nihai bakiyeyi döndürür.
ADJUST/REVOKE: Tam denetim izi ile olağanüstü ayarlamalar.

Garantiler

'X-Idempotency-Key' başlığı (24 saat ≥ TTL) ve operatör tarafında kilitlenme.
Oyuncu/oturum kuyrukları başına - garantili sipariş.
Korelasyon 'round _ id'/' bet _ id'/' session _ id'; Çarpışmalar/çoğalmalar için DLQ.

Ödeme örneği:


POST /wallet/payouts
Idempotency-Key: d0b7-...
{
"player_id": "u_80541",
"round_id": "r_2025_11_02_20_28_44",
"amount_minor": 149000,
"currency": "EUR",
"reason": "round_win"
}

JS Bridge ve Oyun Etkinlikleri

İstemci olayları - operatöre: 'GAME _ INIT', 'SPIN/BET', 'WIN', 'FEATURE _ TRIGGER', 'RESPIN', 'BONUS _ START/END', 'JACKPOT _ HIT', 'ERROR'.
Transport: 'PostMessage'/SDK, ACK/NACK onayları, katı' origin 'doğrulaması ve nonce/signatures.
Amaç: analitik, CRM tetikleyicileri, dinamik afişler, kampanya bağlantısı (ücretsiz turlar/görevler/turnuvalar/damlalar).

Promosyon: freespins, görevler, turnuvalar, ikramiyeler

Free Rounds/Free Spins

Sağlayıcı/Promo API'si aracılığıyla veya bonus motoru ile senkronizasyon.
Parametreler: düzeltin. bet/denom, spin sayısı, son kullanma tarihi, 'game _ id'.
Muhasebe: gerçek/bonus bakiyesindeki kazançlar; vager - operatör/pazar kurallarına göre.

Görevler/Etkinlikler

"Play N spins", "win ≥ X ×", "activate feature M times" - "MISSION _ PROGRESS" aracılığıyla ilerleme.

Turnuvalar/liderlik tabloları

Metrikler: kazançların toplamı, maksimum çarpan, dönüş sayısı; 'TOURNAMENT _ SCORE' boyut için geçerlidir.

Jackpotlar/Ödül damlaları

Çok katmanlı (mini/majör/mega), gizem/ödül damlaları; 'tohum/kap', çoklu para birimi kısıtlamaları.
'JACKPOT _ PAYOUT'u idempotency ile ayırın.

Coğrafi yapılandırma ve uyumluluk

Coğrafi dizin: Başlıkların dahil edilmesi/hariç tutulması, RTP profillerinin seçilmesi, Satın Alma Özelliği/risk oyunlarının devre dışı bırakılması, yaş/bölgesel kısıtlamalar.
Sorumlu oyun: kendini dışlama/zaman aşımı/sınırlar, yerel RG afişleri ve çerezler.
Veri/PII: tanımlayıcıların küçültülmesi ve takma adlarının verilmesi; Günlük depolama süreleri; düzenleyicilerin talebi üzerine ihracat.
Sertifikasyon: Hedef yargı bölgeleri altında sertifikalı derlemelerin/sürümlerin kullanılması.

İzleme, Raporlama ve SLA'lar

Anahtar Metrikler

Bunlar: çalışma zamanı API/Başlatma/CDN, p95 cüzdan geri çağrıları, varlık indirme hızı, JS köprüsü hata kodları.
Ürün: 'Launch> First Spin', 'Spin> Bonus', ARP (B) U, hold, ROI kampanyaları (freespins/missions/tournaments/drops).
Finans: geri ödemelerin/tekilleştirmelerin payı, miktarlardaki anormallikler, gece tutarsızlıkları.

İhracat/Mutabakat

Saatlik/günlük boşaltma (CSV/JSON/S3) tur/işlem/bonus/jackpot tarafından.
'Round _ id/bet _ id/session _ id'ile küçük birimlerde mutabakat; Yinelenen/ihmal/" aptal" collback'lere otomatik uyarılar.

SLO/SLA Benchmarks

API çalışma süresi ≥ 99. 95 %, CDN varlıkları ≥ 99. 9%.
P95 collbecs <500 ms (intraregional).
MTTR - olay planına göre; Prime time/kitlesel kampanyalar için ayrı SLO'lar.

Güvenlik

Taşıma: TLS 1. 2 +, HSTS; Sıkı CSP iFrame etki alanları için.
Erişim: JWT/OAuth2 (istemci), IP-allowlist/signature/mTLS (S2S) gerekirse, sırların döndürülmesi.
Veriler: günlüklerde açık PII yasağı; tokenization/hash 'player _ id'; Operatörde dinlenme/yedekleme sırasında şifreleme.
Anti-dolandırıcılık: spin/bahis oranı anomalileri, çoklu oturumlar, şüpheli ASN/VPN; kotalar/kısma/blok listeleri.

Ölçeklenebilirlik ve hata toleransı

Kenar önbellek: tezahürler/varlıklar/yerelleştirmeler - TTL tarafından yönetilen, sürümlerde manuel engellilik.
Hız sınırları: oyuncu/oturum/API uç noktası başına; Olayların "fırtınalarına" karşı koruma.
Zarif bozulma: varlıkları/etkileri basitleştirmek, olayların sıklığını azaltmak, banner "teknik çalışma".
Yük devretme: yedekleme başlatma/CDN etki alanları; İçeriği kaybetmeden tokeni yeniden yayınlayın.

Kontrol listeleri

Geliştirme için

SSO belirteçleri: kısa TTL, saat eğriliği koruması.
Cüzdan API: idempotent banka/kredi, imza, kuyruklar, DLQ.
JS köprüsü/SDK: olaylar, ACK/NACK, güvenli 'kökeni'.
Promo API: ücretsiz turlar/görevler/turnuvalar/düşüşler; Vager muhasebe.
İhracat: CSV/JSON/S3; Alanların bütünlüğü (küçük birimler, tur/bahis/oturum).

Başlamak için

Coğrafi dizin, RTP profilleri, yasaklanmış özellikleri devre dışı bırakma.
SLO izleme (API/CDN/Cüzdan/JS) + uyarıları.
Gece uzlaşma + yinelenen/atlama uyarıları.
RG/çerez afişleri, yerel gereksinimler.
Olay Planı/Durum Sayfası.

SSS (kısa)

iFrame'de mi çalışıyor? Evet, tutarlı CSP/' X-Frame-Options'ile 'launch _ url' aracılığıyla.
Bonus Buy mevcut mu? Başlığa/pazara göre; yapılandırılmıştır.
Ağ ikramiyeleri var mı? Yapılandırmaya göre; ödemeler - bireysel 'JACKPOT _ PAYOUT'.
Freespins/turnuvalar nasıl bağlanır? Promo/Provider API + analitik etkinlikleri aracılığıyla.
RTP'yi nasıl seçerim? Hedef yargı ve sözleşme kapsamında yapı/katalog düzeyinde.

Toplam

Platipus, açık matematik ve kararlı entegrasyon ile "hafif" HTML5 yuvalarının pratik bir sağlayıcısıdır. Açıklanan kalıpları (SSO/launch-URL, idempotent Cüzdan API, JS köprüsü, promosyon kampanyaları, sıkı coğrafi yapılandırma, izleme ve mutabakat) takiben, operatör istikrarlı bir içerik ekonomisi, yasal uyumluluk ve en yüksek yükler altında güvenilirlik alır.