Oyun Agregasyonu ve Casino API'leri

Casino Game API ve Aggregator API: Temel Farklar

Oyun sağlayıcı API'si ile aggregator API ilk bakışta benzer görünebilir: oyun listesi alınır, oturum açılır, bahis ve kazanç olayları işlenir. Ancak sözleşmeler ve teknik görevler aynı değildir. Doğrudan bağlantı, seçilen bir stüdyonun protokolünü uygulamayı gerektirir. Aggregator bir ara katman ekleyerek farklı sağlayıcıların arayüzlerini ortak hale getirebilir. Bu durum tüm oyunların her ülkede açık olduğu ya da operatör cüzdanının dış kaynak tarafından yönetildiği anlamına gelmez. Karar verirken bağlantı sayısını değil, finansal kontrolü, erişim haklarını ve operasyonel yükü incelemek gerekir.

Tek bir oyun stüdyosu modülü ve ortak API çekirdeğine bağlanan farklı oyun modülleri
Doğrudan sağlayıcı bağlantısı ile aggregator katmanı farklı teknik sorumluluk dağılımları yaratır.
İçindekiler

Game Provider API ve Aggregator API ne anlama gelir?

Game Provider API, belirli bir oyun stüdyosunun operatörlere sunduğu teknik bağlantıdır. Kapsamı slotlar, canlı casino veya sağlayıcının diğer sözleşmeli ürünleri olabilir. Aggregator API birden çok stüdyonun önüne yerleşen ve katalog, oturum ya da mali mesajları ortaklaştırabilen ek bir katmandır.

Tek stüdyo API'si tek oyun demek değildir; aggregator da dünyadaki her oyuna sınırsız erişim sağlamaz. SOFTSWISS çoklu sağlayıcı modelini açıklarken Pragmatic Play doğrudan operatör entegrasyonuna örnek yayımlamıştır. Erişim hakları yine her sözleşme için ayrı doğrulanır. [1] [2]

Entegrasyon sorumlulukları nasıl dağılır?

Doğrudan modelde operatör ekibi her stüdyonun belgelerini, anahtarlarını ve sürüm değişimlerini takip eder. Aggregator teknik adaptörleri yönetip tek geçit sunabilir. Ancak oyuncu fonları, lisanslar, raporlar ve ihtilaflar için kimin sorumlu olduğu anlaşmada belirlenmelidir.

AlanDoğrudan APIAggregator API
SağlayıcılarTek sözleşmeli stüdyoBirden çok etkin stüdyo
AdaptörStüdyoya özel protokolOrtak geçit sözleşmesi
KatalogTek sağlayıcı verisiBirleştirilmiş oyun verileri
CüzdanSağlayıcı olaylarıOlası callback normalizasyonu
DestekStüdyo ile doğrudanÖnce aggregator, sonra stüdyo
SürümHer stüdyo için bakımGeçit ve eşleme bakımı

Tek API, sorun sırasında tek kuruluş olduğu anlamına gelmez. Oyuncu bakiyesi, oturum hatası, oyun kesintisi, ülke kısıtı ve çekişmeli tur için bir sorumluluk matrisi oluşturun. [3]

Oyun kataloğu, kimlikler ve erişim hakları nasıl yönetilir?

Stüdyo genellikle kendi oyun kodlarını kullanır. Aggregator buna kendi katalog ID'sini ekleyebilir. Bir oyunun yeniden adlandırılması, kapatılması veya sürümünün değişmesi halinde doğru kaydı bulmak için bu kimliklerin ayrı izlenmesi gerekir.

  • Operatör iç ID'sini, aggregator ID'sini ve orijinal sağlayıcı kodunu ayırın.
  • Ülke, marka, para birimi, dil ve cihaz uygunluğunu oyun düzeyinde tutun.
  • Listelenen oyunun lisanslı ve gerçekten başlatılabilir olduğunu ayrıca test edin.
  • Görsel, ad, RTP sürümü ve etkinlik değişikliklerini geçmişe işleyin.

Satış sunumundaki toplam oyun sayısı yeterli değildir. Sizin API anahtarınızla görünen oyunları ve hedef ülkedeki gerçek oturum açma sonucunu doğrulayın. [3]

Oyun başlatma ve tur yaşam döngüsü nasıl değişir?

Oyuncu oyunu seçince operatör sunucusu kimliği ve uygunluğu kontrol eder, ardından stüdyo ya da aggregator üzerinden oturum oluşturur. Dönen URL veya token oyunu açar. Bahis ve kazanç mesajları cüzdana geri ulaşır; aracı katman varsa mesaj biçimi dönüştürülebilir.

  1. Oyuncu, oyun, marka, ülke, para birimi, limit ve kullanılabilir bakiyeyi doğrulayın.
  2. Oturumu doğru oyun ID'si, sunucu anahtarları ve izinli parametrelerle oluşturun.
  3. Başlatma bağlantısının süresini ve tekrar kullanım kuralını sözleşmeden okuyun.
  4. Bahis, kazanç, iade ve geri almaları benzersiz kimlikle tek kez uygulayın.
Doğrudan oyun API'si, çoklu sağlayıcı geçidi ve operatörün mali kontrollerini gösteren üç panel
Aracı katman mesajları ortaklaştırabilir; gerçek mali kayıt yine operatörün kontrolündedir.

Yanıt kaybolsa bile karşı sistem işlemi tamamlamış olabilir. Örnek aggregator belgelerinde operatör, geçit ve stüdyo ayrı aktörlerdir; o ürünün tekrar ve oturum kuralları tüm sağlayıcılar için genellenmemelidir. [4]

Cüzdan callback'leri ve finansal mutabakat kimin görevidir?

Operatör cüzdanı kendisi tutuyorsa bakiye hareketlerini güvenle kaydetmek zorundadır. Aggregator ortak payload sunabilir ama imza, oyuncu, tutar, para birimi ve tekrar eden olay kontrolleri yine gereklidir. Başarılı HTTP yanıtı, kalıcı defter kaydı yerine geçmez.

OlayOperatör kontrolüSaklanacak kanıt
BahisFon ve limit kontrolü; tek borçİşlem ve tur ID'si
KazançTek kez bakiye artırmaTutar ve para birimi
İadeİlk işleme bağlı düzeltmeOrijinal işlem referansı
TekrarKayıtlı sonucu döndürmeIdempotency anahtarı
MutabakatKayıt farkını araştırmaStüdyo, geçit ve defter raporu

Bir aggregator callback dokümanı imzalı mesajları ve sağlayıcı işlem kimliklerini açıklar. Bu, ağın aynı olayı yalnız bir kez teslim edeceği anlamına gelmez; tekrarları kalıcı kayıtlardan tanıyın. [4]

Güvenlik ve API sözleşmesinde neler aranmalı?

Her iki bağlantı da ayrı güven alanları arasında çalışır. Anahtar sahipliği, sunucu imzaları, oyuncu yetkisi ve cüzdan nesnelerine erişim iyi tanımlanmalıdır. Aggregator özel adaptör ihtiyacını azaltırken yeni bir servis bağımlılığı ekler.

  1. Sürüm içeren şema, hata kodu, retry, rate limit ve kullanım dışı bırakma planı isteyin.
  2. İmza ve oyuncu yetkisini sunucuda doğrulayın; istek içindeki ID'ye körü körüne güvenmeyin.
  3. Test ve üretim anahtarlarını ayırın, erişimi sınırlandırın ve rotasyon planı hazırlayın.
  4. Replay, sahte oyuncu, yasak marka erişimi ve callback patlamalarını test edin.

OpenAPI, HTTP arabirimini tanımlamak ve sözleşme testleri üretmek için kullanılabilir. Ancak dokümantasyonun doğruluğu güvenli uygulama garantisi değildir; OWASP API erişim kontrolü risklerini özellikle ele alır. [5] [6]

Lisans, sertifikasyon ve oyun hakkı seçimi nasıl etkiler?

API'nin teknik olarak çalışması, ilgili ülkede oyunu işletme hakkı vermez. Sözleşmeli içerik hakları, operatör lisansı, sağlayıcı onayları ve sertifika sürümleri pazara göre değişir. Aggregator bu belgelerin koordinasyonunu üstlenebilir, fakat kapsamını teyit etmek gerekir.

  • İçerik dağıtım hakkını, sözleşme zincirini ve geçerli ülkeleri doğrulayın.
  • Hedef pazar için geçerli sertifika ve oyun sürümü kayıtlarını isteyin.
  • Bir oyunu kimin kapatacağı ve resmi taleplere kimin yanıt vereceğini belirleyin.
  • Oturumdan önce oyuncu, marka, para birimi ve coğrafya uygunluğunu kontrol edin.

GLI, etkileşimli oyun sistemleri için GLI-19 dahil test standartları yayımlar. Hangi sürümün ve şartın zorunlu olduğuna ilgili ülke yetkilileri karar verir. Genel 'sertifikalı' ifadesi tek başına kanıt değildir. [7]

Destek, kesinti ve sürüm güncellemeleri nasıl farklılaşır?

Doğrudan bağlantıda arıza genellikle stüdyo ile çözülür. Aggregator modelinde ilk destek noktası geçit sağlayıcısı olabilir ve olay stüdyoya taşınır. Merkezi yönetim kolaylık sağlar; fakat uçtan uca loglar olmadan kök nedeni bulmak zorlaşır.

DurumDoğrudan APIAggregator
Tek stüdyo kapalıO stüdyonun oyunlarını gizleEtkilenen oyunları listeden çıkar
API değişikliğiStüdyo adaptörünü yenileGeçit şemasını ve eşlemeyi test et
İtirazlı turStüdyodan işlem kaydı alGeçit ve stüdyo ID'sini izle
Katalog değişimiTek akışı yenileBirleşik akışları doğrula
Toplu kesintiStüdyo bağlantısını inceleGeçit ve üst sistemleri incele

Gateway ve stüdyo SLA'larını, olay bildirimlerini, finansal raporları ve geri dönüş adımlarını ayrı değerlendirin. Ortak API, tüm riskleri ortadan kaldırmaz.

Hibrit bir bağlantı ne zaman daha iyidir?

Bir operatör büyük oyun kataloğunu aggregator üzerinden, stratejik stüdyoları ise doğrudan kullanabilir. Bu yöntem esneklik verir fakat aynı oyunun iki kez görünmesine ve farklı versiyonların finansal kayıtları karıştırmasına yol açabilir.

  • Her ticari oyun için kalıcı iç kimlik oluşturun ve tüm kaynak eşlemelerini saklayın.
  • Aktif bağlantıyı denetlenebilir bir kuralla seçin, rastgele URL ile değil.
  • Yinelenen oyunları, jackpot ve promosyon farklarını saptayın.
  • Tamamlanmamış bahisleri sözleşmeler arasında taşımayın; kurtarma kuralı belirleyin.

Taşıma öncesinde açık oturumları, sonuçlanmamış turları, callback kuyruğunu ve finansal raporları karşılaştırın. Oyuncunun işlem geçmişi teslimat yolu değişince bozulmamalıdır.

Operatör doğru API modelini nasıl seçmeli?

Gerçekte gereken stüdyo sayısı, kurum içi geliştirme gücü, hedef ülkeler ve özel özellikler seçimde temel ölçütlerdir. Aynı test senaryolarını adaylara uygulayın; kurulumun yanında bakım, destek, sertifika çalışması ve çıkış maliyetlerini hesaplayın.

  1. Hesabınıza açık oyunları, ülkeleri, markaları ve para birimlerini yazılı alın.
  2. Katalog, oturum, bahis, kazanç, iade ve tekrar senaryolarını test edin.
  3. Sürüm kuralları, imzalar, izleme ID'leri ve mutabakat raporlarını inceleyin.
  4. Yıllık mühendislik, destek ve geçiş maliyetini ticari ücretlerle birlikte hesaplayın.

Az sayıda önemli stüdyo ve güçlü teknik ekip için doğrudan API anlamlıdır. Çok sayıda yetkili stüdyo ve ortak arayüz isteyenler için aggregator uygundur. Hibrit model ise titiz katalog ve muhasebe kontrolü gerektirir. [1] [2] [3]

Kaynaklar ve ek okumalar

Diyagram görüntüleyici