Jackpot API nasıl çalışır

Tam makale

💡 18+. Malzeme, oynama çağrısı olmadan mühendislik uygulamasıdır. Şartlar: platform - PAM/cüzdan/nakit masası/bonuslar/RG; RGS - Uzaktan Oyun Sunucusu (stüdyo oyunlarının çekirdeği); toplayıcı - birden fazla RGS için birleştirilmiş katman; JP - jackpot hizmeti.

1) Jackpot sistemi nedir ve ekosistemde nerede duruyor?

Jackpot sistemi, bahislerden katkı toplayan, havuzları ve kazanma tetikleyicilerini yöneten, ödüllerin dağılımını hesaplayan ve operatörün ödeme döngüsü aracılığıyla ödemeleri başlatan ayrı bir hizmettir (bazen bir hizmet kümesi). Bütünleştirir:

RGS ile (oranlar/sonuçlar ve nitelikler hakkında mesajlar), bir platform/cüzdan (katkıları yazma ve kazançları kredilendirme), bir toplayıcı (birçok stüdyo/markadan yönlendirme), bir BI/düzenleyici (telemetri ve raporlama).

2) Jackpot türleri (ve API'da ne gibi değişiklikler)

1. Sabit - Önceden bilinen ödül miktarı. API'da havuz yoktur, sadece koşul kontrolü ve kredi vardır.

2. Aşamalı: Havuz bahis katkılarından büyür. Katkının son noktalarına ve mevcut boyutun yayınlanmasına ihtiyacımız var.

3. Çok katmanlı (Çok katmanlı: Mini/Major/Grand): Farklı oranlarda ve kapaklarda çoklu paralel havuzlar.

4. Yerel vs ağ: yerel havuz - bir operatör/marka; Ağ - birçok operatör/marka/bölge için toplam (çoklu kiracılık ve çoğaltma kritik öneme sahiptir).

5. Zaman/etkinlik: Son teslim tarihi olan veya zamanlanmış bir havuz (zamanlayıcılar ve otomatik çizimler gereklidir).

3) Parasal değişmezler

Dengedeki gerçeğin kaynağı platformun cüzdanı/defteridir. JP yalnızca havuzların ve yükümlülüklerin durumunu saklar.

Tüm para işlemleri idempotent (anahtarlar 'jp _ curb _ id', 'jp _ trigger _ id', 'jp _ payout _ id').

Kayıp/Çoğaltılmış Ödemeler = 0. Tazminat - manuel veritabanı düzenlemeleriyle değil, yalnızca olaylarla (saga).

Kendi telemetrinizle bağımsız işlemler olarak ayrı katkı, tetikleme ve ödeme.

4) API Referans Sözleşmeleri

4. 1 RGS/> toplayıcı JP (katkılar ve tetikleyiciler)

'POST/v1/jp/contributions' - havuz katkısının muhasebeleştirilmesi

Json
{
" :" uuuid-1 "," : "brand-42", " :" grand-eu-01 "," : " " " :" " " ":"  "" bahis ": {" miktar ": 2. 00, "para birimi": "EUR"}, "-": {"miktar": 0. 02, "para birimi": "EUR"}, "occurred_at": "2025-10-23T15:12:05Z," "idempotency_key": "round_r_123"
}

'POST/v1/jp/candidates' - katılım/koşulların doğrulanması için başvuru (isteğe bağlı)

Cevap: 'uygun: doğru/yanlış', ağırlık veya şans, kurallar.

'POST/v1/jp/triggers' - işlem gerçeğini kaydetme

Json
{
" :" uuuid-2 "," : "grand-eu-01", "reason": " " "selector": {"player _ id": " " " ", " ", " " ":"  "
}

💡 Not: Bazı modellerde, tetikleyici JP'nin kendisi (dahili rulet) tarafından başlatılır ve RGS sadece turu bildirir. Ardından 'tetikleyiciler' JP - platform olarak adlandırılır ve RGS etkinliğe abone olur.

4. 2 JP - platform (ödemeler/karşılıklar)

'POST/v1/wallet/reserve' - (isteğe bağlı) gelecekteki ödemeler için provizyon

'POST/v1/cüzdan/kredi' - oyuncu kazanma kredisi

Json
{
"jp_payout_id":" uuuid-3 "," tenant_id": "brand-42", "player_id":" p_abc, "pool_id":" grand-eu-01 "," miktar ": {" miktar ": 500000. 00, "currency": "EUR"}, "meta": {"tax": "withded = false", "tier": "grand"}, idempotency_key": "jp_p_grand_r_123"
}

Platform yanıtları: 'Kredi. Tamam	Sebep kodları (RG/AML, para çekme limitleri, yaptırımlar, coğrafi blok) ile başarısız oldu.

4. 3 Yayınlama havuzu durumu (ön/widget'lar için)

'GET/v1/jp/pools/{ pool _ id}' - mevcut boyut, tohum, cap, katılımcı sayısı, ETA, vb.

'GET/v1/jp/pools' - filtreli marka/bölgeye göre havuzların listesi.

5) Olay modeli (Kafka/Pulsar) ve diyagramlar

Temel konular:

'Jp. katkı. kaydedilmiş '
'Jp. bilardo. Güncellendi '(boyut, rekabetçi güncellemeler)
'Jp. tetiklendi '

'Jp. ödeme. Talep edilen	kredilendirildi	Başarısız oldu '
'wallet. Kredi. '(sagalar için yansıtma)
'rg. limit. Vur ',' aml. alarm. 'açıldı (ödeme engellenirse)
'audit. Yapılandırma. Değişti '(limitler, tohum, kap, dağıtım)

Sözleşmeler: Avro/JSON Schema + Schema Registry, katılım anahtarları 'tenant _ id', 'pool _ id', 'player _ id'. Sürüm oluşturma - geriye dönük uyumlu.

6) Tetikleme algoritmaları (üst düzey)

Olasılıksal (p-stabil): Her nitelikli tur için olasılık 'p'ile bir isabet oluştururuz (havuz/seviye türüne bağlı olarak).

Aralık (düşmeli): Havuz, cap-sum veya son teslim tarihine düşmelidir - iç rastgele [min, max], publish cap/ETA aralığında tutun.

Tohum ve entropi yönetimi: sunucu tohumu + yuvarlak tuz; Müşteri jackpot koltuklarını terk etmek. Tohumdaki tüm değişiklikler WORM denetimi altındadır.

Dürüstlük: Tetikleyici, oyuncunun özel kişiliğine bağlı olmamalıdır (coğrafi/lisans/yeterlilik kuralları dışında). Herhangi bir "kişisel" hedefleme tabudur.

7) SLO ve performans

P95 'katkısı' <120 ms, p99 <250 ms.

P95 'tetik> kredi' <500 ms (harici ödeme şerbetçiotu olmadan).

"Kayıp/çoğaltılmış ödemeler" = 0 (sözleşme testleri ile kontrol edilir).

BI ≤ 5 dakika etkinlik teslimatı.

Kritik yollar için JP API kullanılabilirliği ≥ 99. 95%.

8) Güvenlik ve uyumluluk

Tüm S2S mTLS + imzaları (HMAC/EdDSA) kısa ömürlü belirteçleri çağırır.

Sıfır güven: ağ ilkeleri/ağ, minimum ayrıcalıklar, bölgeye göre segmentasyon.

Sınırlarda, formüllerde, tohum/entropide, havuz yapılandırmalarında yapılan değişikliklerin WORM denetimi.

GDPR/Veri ikamet/PCI: PII ve günlükleri - bölgede; Hassas alanların tokenizasyonu; bölgeler arası okumaları yasaklamak.

RG/AML: Ödeme sırasında senkron fren lambaları; SAR/STR yüklemeleri otomatiktir.

9) Tutarlılık ve destanlar

Katkı ('katkı') - JP'de düzeltme, 'jp yayınla. katkı. kaydedildi '.

Tetik ('tetiklendi') - bir yükümlülük oluşturur; JP 'payout' saga başlattı.

Ödeme ('payout. Talep edilen cüzdan. Kredi. Tamam ') - destan biter; Sahte ile - veri tekilleştirme ile retrai.

Outbox/CDC, etkinlikleri yayınlamanın tek yoludur; "Bypass" kaydedici yok.

10) Telemetri ve gösterge panoları

İş:

'pool _ size', '_ _ rate', 'avg _ _ _ per _ bet', 'time _ to _ drop', 'payouts _ count/sum', 'tier _ distribution'.

Teknik:

P50/p95/p99 по 'katkı', 'tetikleme', 'ödeme';
Hata oranı с типами (5xx/4xx/business), yeniden deneme fırtınaları, kuyruk gecikmesi;
'wallet. Kredi 'gecikme/ok-rate; Havuz güncelleme çakışması.

Uyarılar:

growth 'paout. Başarısız oldu '> X % marka/bölgeye göre,' pool _ size '> cap - Zamanın % Y'si (yapılandırma hatası),' pool _ size've uzlaşma katkı miktarı> Z ppm arasında sürüklenme.

11) Çok kiracılık ve izolasyon

Tüm istek ve etkinlikler 'tenant _ id/brand _ id/license/region'olarak işaretlenmiştir.

Yerel/ağ havuzları farklı lisanslar/bölgeler altında fiziksel olarak ayrılır (DB/cluster).

BI vitrinlerinde sıra düzeyinde güvenlik (RLS) ve maskeleme.

Marka/bölge başına bireysel anahtarlar/sırlar ve şematik alanlar.

12) Bonuslar/turnuvalarla entegrasyon

Katkılar doğrudan vageri arttırmaz; Bonusa katkı - katkıdan değil, bahisten gelir.

Turnuvalar "JP katılımı" veya'en yüksek katkı "için puan verebilir. "Kaynak - olaylar 'jp. katkı. Kaydedilen 'и' jp. tetiklendi '.

Zorunlu kural: Jackpot mekaniği oyunun temel RTP'sini değiştirmez; Aksi takdirde ayrı sertifikasyon gereklidir.

13) Test ve kaos uygulamaları

Sözleşme testleri RGS↔JP↔koshelyok: çift teslimat, gecikmeler, sipariş dışı, geri alma.

Yük testleri: bahislerin ve tetikleyicilerin fırtınası, havuz işçilerinin ölçeklendirilmesi.

Kaos egzersizleri: JP bölgesinin düşüşü, çevrimdışı cüzdan, zaman uyumsuzluğu; Giden kutusunu ve bozulmayı işaretleyin (duraklatma tetikleyicileri/yeni katkı yok).

14) Kontrol listeleri

Studio/RGS için

Idempotent 'katkı've doğru' round _ id'/' bet _ id '.
İşlemleri "atlayan" yayınlar yok (yalnızca giden kutusu/CDC).
Yinelenen/tekrarlanan tetikleyicilerin/tazminatların testleri.
maksimum bahis/yeterlilik limitleri JP'ye aktarılır.

Operatör/platform için

Ledger gerçeğin kaynağıdır, 'cüzdan. veri tekilleştirme ile kredi.
RG/AML durakları ücretli olarak işlenir; SAR/STR raporları.
p95 'tetik> kredi' panoları, hata oranı, havuz mutabakatları.

JP Sahibi için

Formül/tohum/limit değişikliklerinin WORM denetimi.
Kayıt Defterindeki ve sürümlerdeki olay şemaları.
DR: RPO ≤ 5 dk, RTO ≤ 30 dk; Düzenli egzersizler.
Marka/lisansa göre RLS/izolasyon; Bölge başına anahtarlar/sırlar.

15) Kırmızı bayraklar (anti-desenler)

Veritabanındaki havuz boyutlarının ve ödemelerin manuel düzenlemeleri.

Idempotence eksikliği - yinelenen krediler.

Giden kutusu/CDC olmadan telemetri yayınlamak - "kayıp" katkılar/tetikleyiciler.

PII ve farklı bölgelerin parasal verilerini karıştırma.

Yeni sertifika olmadan temel oyunun RTP'sini etkileyen ikramiye.

Cüzdan ve havuz mutabakatı yok; Raporlar savaş OLTP dayanmaktadır.

Jackpot systems API, bir stüdyo, platform ve operatör arasındaki parasal olay sözleşmesidir. Temeli: idempotans ve sagalar, paranın sıkı izolasyonu, açık olay şemaları, güvenlik ve WORM denetimi, gözlemlenebilirlik ve SLO. Bu tasarımda, düzeltme/aşamalı ve ağ havuzları tahmin edilebilir şekilde ölçeklenir, ödemeler doğru kalır ve düzenleyici ve iş raporları şeffaf ve güvenilirdir.