Casino oyun agregatör API'si: Nasıl kurgulandı?

API'nin yapısı

Sizin tarafınızdan gelen istekler, JSON POST gövdeleri olarak tek bir endpoint'e gider. Her istek kullanıcı adınızı, şifrenizi ve çağırmak istediğiniz metodun adını taşır. Yanıtlar JSON olarak döner. Ürün başına ayrı base URL'ler, canlı casino veya spor için ikinci bir doküman yok: tek bir igaming API, 40.000'i aşkın oyundan oluşan kataloğun tamamını ve sportsbook'u kapsar.

Ters yöndeki trafik, yani bizden size gelen, seamless wallet'tır: bir oyuncunun bakiyesinin okunması ya da değiştirilmesi gerektiğinde sunucunuzu çağırırız. Bu callback'ler, sorgu parametreli imzalı HTTP GET istekleri olarak gelir.

Çağırdığınız metotlar

Oyun listesi

Oyun listesi lobinizin omurgasıdır. Her kaydın, sizin saklayıp açılışta değiştirmeden geri gönderdiğiniz sabit bir kimliği vardır. Oyun türü alanı stüdyolar arasında zaten standartlaştırılmıştır; dolayısıyla "Slotlar", "Canlı", "Crash", "Masa" ve "Spor" bölümlerini doğrudan yanıttan oluşturabilirsiniz. Canlı masalar ve sportsbook bu listedeki birer kayıttan ibarettir.

Açılış

Bir oyunu açmak için oyuncuyu, oyun kimliğini, cihazı (masaüstü veya mobil) ve oyuncunun ülkesini, isteğe bağlı olarak da dili gönderirsiniz. Karşılığında bir iframe içinde yükleyeceğiniz bir URL alırsınız. Ülke önemlidir: bazı stüdyolar belirli pazarları hariç tutar ve biz bunu IP adresinden tahmin ederek değil, her zaman sizin gönderdiğiniz ülkeye göre uygularız. Ülkeyi her gerçek paralı açılışta gönderin.

Demo

Yaklaşık 16.000 slot aynı kalıpla demo modunda açılabilir. Oyuncu kaydı gerekmez ve hiçbir callback tetiklenmez; bu da demo açılışlarını herkese açık sayfalarda güvenli kılar.

Seamless wallet callback'leri

Oyuncu parası platformunuzdan hiç çıkmaz. Callback URL'nize üç aksiyon göndeririz:

• balance: oyuncunun güncel bakiyesini okur; genellikle bir oturum açıldığında.
• debit: bir bahis. Tutarı düşün ve yeni bakiyeyi döndürün ya da güncel bakiyeyle birlikte yetersiz bakiye kodu döndürün.
• credit: bir kazanç. Tutarı ekleyin ve yeni bakiyeyi döndürün.

Her çağrı benzersiz bir işlem kimliği (transaction id), bir tur kimliği ve oyun kimliği taşır. Tutarlar, para biriminin küçük biriminde tam sayılardır. Endpoint'iniz her zaman HTTP 200 ile yanıt verir; sonuç JSON gövdesinde bir hata kodu olarak yer alır: başarılı, yetersiz bakiye veya işlem hatası.

Rollback'ler

Rollback ayrı bir aksiyon değildir. Rollback bayrağı taşıyan bir debit veya credit olarak gelir ve onu diğer her hareket gibi işlersiniz. Onu güvenli kılan, işlem kimliği üzerinden yaptığınız tekilleştirmedir.

Güvenlik

Her callback bir zaman damgası ve bu zaman damgasıyla sizin gizli salt değerinizden türetilmiş bir anahtar içerir. Kısa bir zaman aralığının dışında kalan ya da anahtarı eşleşmeyen her şeyi reddedin. Daha güçlü koruma için her callback ayrıca tüm parametreleri üzerinden hesaplanmış bir HMAC-SHA256 başlığı taşır; böylece değiştirilmiş bir tutar ya da kullanıcı adı doğrulamadan geçemez.

Free spin'ler ve free round'lar

Bu adı iki farklı şey paylaşıyor ve kesin olmakta fayda var.

Oyun içi free spin'ler, hiçbir şey geliştirmenize gerek kalmadan kataloğun tamamında çalışır. Scatter ile tetiklenen free spin'ler, bonus turları, feature buy'lar ve jackpotlar oyunun içinde döner ve kazançları size sıradan credit'ler olarak, çoğu zaman karşılığında bir debit olmadan ulaşır. Handler'ınızın bu tür credit'leri kabul etmesi gerekir.

Promosyonel free round'lar, yani bir oyuncuya hoş geldin teklifi olarak verdiğiniz türden olanlar, bizim tarafımızda self-servis API çağrıları değildir. Bonus planınız free round vermeye dayanıyorsa, geliştirmeye başlamadan önce bizimle konuşun; aklınızdaki oyunlar için neyin ayarlanabileceğini size söyleriz.

Para birimleri

Para birimi oyuncu başına belirlenir. Tek bir hesap birçok para biriminde oyunculara hizmet verebilir ya da bir site tek bir para birimine kilitlenebilir. Ana çok stüdyolu slot yelpazesi ve sportsbook; EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR ve ETB dahil 38 ISO para birimini destekler. Diğer yelpazeler stüdyodan stüdyoya para birimi ekler ya da çıkarır; bu yüzden herhangi bir broşürü değil, para birimi metodunu esas alın.

Aynı API üzerinden sportsbook

Kataloğumuzdaki sportsbook olan Nocturn Sport, bir slotla aynı çağrıyla açılır ve aynı üç callback üzerinden kapanır. Maç öncesi ve canlı bahisler, yerleştirildiğinde oyuncudan düşülür ve sonuçlandığında oyuncuya eklenir; uzun vadeli (outright) bahislerde bu saatler hatta günler sonra olabilir. CS2, Dota 2 ve Valorant gibi espor branşları futbol, tenis ve basketbolun yanında yer alır. Sportsbook GGR'ındaki payımız %12'dir. Spora özgü ayrıntılar sportsbook API sayfasında.

Çok markalı kurulumlar

Birden fazla site işleten operatörler iki kez entegre olmaz. Her ek marka aynı hesap altında kendi kimlik bilgilerini ve callback URL'sini alır; lisanslarınız gerektiriyorsa katalog siteden siteye farklılaşabilir.

Sonraki adımlar

Hızlı casino API entegrasyonu sayfasındaki adım adım sırayı izleyin, maliyetleri fiyatlandırma sayfasında kontrol edin ya da kimlik bilgilerini API anahtarı sayfasından talep edin. Birkaç agregatörü değerlendiriyorsanız, karşılaştırma merkezi her birinin cüzdanını nasıl belgelediğini yan yana koyuyor.