Entegrasyon modeli
Her harici servis platforma, kendi kategorisinin sözleşmesini uygulayan bir adaptör üzerinden ulaşır. Platform sağlayıcıyla doğrudan değil, sözleşmeyle konuşur.
01Adaptör kategorileri
Bir kategori, adaptörün neleri yapabilmesi gerektiğini tanımlar. Arkasındaki sağlayıcı, platformun geri kalanı fark etmeden değişebilir.
games.*
Casino oyunları sağlayan stüdyolar ve içerik agregatörleri.
Sözleşmenin kapsamı
sportsbook.*
Karşılaşma, market, oran ve sonuç sağlayan harici sportsbook servisleri.
Sözleşmenin kapsamı
payments.*
Oyuncular ile operatörün hesapları arasında para aktaran sağlayıcılar.
Sözleşmenin kapsamı
kyc.*
Operatörün seçtiği kimlik doğrulama, tarama ve izleme servisleri.
Sözleşmenin kapsamı
messaging.*
Operatör adına oyuncularla iletişim kuran kanallar ve araçlar.
Sözleşmenin kapsamı
export.*
Operasyonel verinin hedefleri: veri ambarları, iş zekâsı araçları ve düzenleyici raporlama.
Sözleşmenin kapsamı
02Entegrasyon modeli
Kategoriler yaptıkları iş bakımından ayrışır. Bir şeyler ters gittiğinde nasıl davrandıkları ise ortaktır.
Bir kategorideki her adaptör aynı işlemleri aynı anlamla uygular.
Zaman aşımları, artan aralıklı yeniden denemeler ve devre kesme adaptör bazında uygulanır. Tek bir sağlayıcıdaki sorun diğerlerini etkilemez.
Cüzdana dokunan her işlem idempotent'tir ve sağlayıcının kendi kayıtlarıyla mutabık kılınabilir.
Adaptör bazında gecikme, hata oranı ve devre durumu konsolda gösterilir ve API üzerinden alınabilir.
Her kategorinin üretilmiş veriyle çalışan bir sandbox adaptörü vardır; geliştiricileriniz sağlayıcı hesabı olmadan test edebilir.
// Illustrative shape of a game source adapter. Not a published SDK.
export interface GameSourceAdapter {
listGames(market: string): Promise<CatalogEntry[]>;
createLaunch(request: LaunchRequest): Promise<LaunchSession>;
// Wallet operations are idempotent: same key, same result.
onDebit(event: RoundDebit): Promise<WalletResult>;
onCredit(event: RoundCredit): Promise<WalletResult>;
onRollback(event: RoundRollback): Promise<WalletResult>;
health(): Promise<AdapterHealth>;
}Temsili bir yapıdır, yayımlanmış bir SDK değildir. Sözleşmeler, entegrasyon sürecinde kategori bazında belgelenir.
03Adaptörün devreye alınması
Adaptör hazır da olsa, sıfırdan da geliştirilse aynı altı adım izlenir. Fark, ortadaki adımların ne kadar sürdüğündedir.
01
Adaptörün hangi sağlayıcıyı, hangi pazarları ve hangi işlemleri desteklemesi gerektiği belirlenir.
ÇıktıEntegrasyon özeti
02
Sağlayıcının protokolü kategori sözleşmesiyle eşlenir ve her fark belgelenir.
ÇıktıEşleme belgesi
03
Adaptör, sağlayıcının test ortamına ya da bir simülatöre karşı geliştirilir veya etkinleştirilir.
ÇıktıSandbox adaptörü
04
Kategori test paketi çalıştırılır: idempotency, yeniden denemeler, geri almalar, zaman aşımları ve mutabakat.
ÇıktıTest kanıtları
05
Adaptör önce tek bir marka ya da pazar için açılır; yaygınlaştırmadan önce sağlığı izlenir.
ÇıktıCanlıya geçiş kontrol listesi
06
İzleme, uyarılar ve mutabakat sürekli çalışır. Sağlayıcı tarafındaki değişiklikler adaptör güncellemesi olarak ele alınır.
ÇıktıOperasyon kılavuzu
04Durumlar
Bu üç ifadeyi dokümantasyonumuzda ve konsolda adaptörlerin yanında görürsünüz. Ticari bir ilişkiyi değil, yazılımın durumunu anlatırlar.
Adaptör geliştirilmiş ve uygunluk testlerinden geçmiştir. Sağlayıcıyla kendi anlaşmanız yürürlüğe girdiğinde canlı kiracıda etkinleştirilebilir.
Sizin için anlamı
Adaptör sandbox ortamında, bir simülatöre ya da sağlayıcının kendi test ortamına karşı çalışır. Gerçek trafik için değil, geliştirme ve test içindir.
Sizin için anlamı
Kategori sözleşmesi bu bağlantıyı destekler, ancak adaptör henüz geliştirilmemiştir. Kapsamı ve takvimi, ihtiyaç duyan operatörle birlikte belirlenir.
Sizin için anlamı
Bir iş ortağı listesi yayımlamıyoruz. Hangi sağlayıcıların bağlanacağı her operatörün lisanslarına ve anlaşmalarına bağlıdır; keşif aşamasında netleştirilir.
Sonraki adım
Sağlayıcı listenizi ve pazarlarınızı paylaşın. Bunları adaptör kategorileriyle eşleyip gereken çalışmayı gösterelim.