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.
Yayın tarihi
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.
Alan
Doğrudan API
Aggregator API
Sağlayıcılar
Tek sözleşmeli stüdyo
Birden çok etkin stüdyo
Adaptör
Stüdyoya özel protokol
Ortak geçit sözleşmesi
Katalog
Tek sağlayıcı verisi
Birleştirilmiş oyun verileri
Cüzdan
Sağlayıcı olayları
Olası callback normalizasyonu
Destek
Stüdyo ile doğrudan
Önce aggregator, sonra stüdyo
Sürüm
Her stüdyo için bakım
Geç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.
Oyuncu, oyun, marka, ülke, para birimi, limit ve kullanılabilir bakiyeyi doğrulayın.
Oturumu doğru oyun ID'si, sunucu anahtarları ve izinli parametrelerle oluşturun.
Başlatma bağlantısının süresini ve tekrar kullanım kuralını sözleşmeden okuyun.
Bahis, kazanç, iade ve geri almaları benzersiz kimlikle tek kez uygulayın.
⊕Diyagramı büyütAracı 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.
Olay
Operatör kontrolü
Saklanacak kanıt
Bahis
Fon ve limit kontrolü; tek borç
İşlem ve tur ID'si
Kazanç
Tek kez bakiye artırma
Tutar ve para birimi
İade
İlk işleme bağlı düzeltme
Orijinal işlem referansı
Tekrar
Kayıtlı sonucu döndürme
Idempotency anahtarı
Mutabakat
Kayıt farkını araştırma
Stü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.
Sürüm içeren şema, hata kodu, retry, rate limit ve kullanım dışı bırakma planı isteyin.
İmza ve oyuncu yetkisini sunucuda doğrulayın; istek içindeki ID'ye körü körüne güvenmeyin.
Test ve üretim anahtarlarını ayırın, erişimi sınırlandırın ve rotasyon planı hazırlayın.
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.
Durum
Doğrudan API
Aggregator
Tek stüdyo kapalı
O stüdyonun oyunlarını gizle
Etkilenen oyunları listeden çıkar
API değişikliği
Stüdyo adaptörünü yenile
Geçit şemasını ve eşlemeyi test et
İtirazlı tur
Stüdyodan işlem kaydı al
Geçit ve stüdyo ID'sini izle
Katalog değişimi
Tek akışı yenile
Birleşik akışları doğrula
Toplu kesinti
Stüdyo bağlantısını incele
Geç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.
Hesabınıza açık oyunları, ülkeleri, markaları ve para birimlerini yazılı alın.
Katalog, oturum, bahis, kazanç, iade ve tekrar senaryolarını test edin.
Sürüm kuralları, imzalar, izleme ID'leri ve mutabakat raporlarını inceleyin.
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]