Casino API nedir
API, bir sistemin başka bir sistemden bilgi ya da bir eylem istemesinin tanımlı bir yoludur. Casino API bu fikri bir online casino işletmeye uygular: platformunuz oyunları ister ve açar, içerik tarafı ise bakiyeleri ve bahisleri platformunuza sorar. Sözleşme istekleri, alanları, yanıtları ve hataları adlandırır; böylece iki ekip her gün konuşmak zorunda kalmadan aynı sözleşmeye göre geliştirme yapabilir. Kısacası casino API bir kullanım kılavuzu gibidir: iki tarafın birbirinden neyi, hangi biçimde isteyebileceğini önceden yazılı hale getirir.
WGC API'si sunucudan sunucuya bir arayüzdür. Sunucunuz onu X-API-Key başlığındaki bir anahtarla çağırır ve her yanıt aynı zarfla gelir: bir ok bayrağı, bir istek kimliği ve ya veri ya da bir hata. Kodunuzu yalnızca hata koduna göre dallandırmalısınız; çünkü mesaj insanlar için yazılmıştır. Tarayıcılar API'yi doğrudan çağırmaz ve çapraz kaynak çağrıları desteklenmez; yani anahtar sunucunuzda kalır.
Casino API'nin dört işi
Aşağıdaki dört iş, bir entegrasyonun her aşamasında karşınıza çıkar ve her biri API'nin ayrı bir bölümüne karşılık gelir.
1. Katalog. Platformunuz hesabına verilen oyunları, sayfa başına 200 olarak ister. Her oyunun, onu kataloğunuzda tanımlayan sabit bir publicId'si ve aynı oyun için katalog genelinde aynı olan bir universalId'si vardır. Ayrıca bir adı, bir türü, görsel adresleri ve demo, ücretsiz döndürme gibi yetenekler için bayrakları bulunur. İlk tam indirmeden sonra son senkronizasyon zamanınızı gönderir ve yalnızca değişiklikleri alırsınız; kaldırılacak oyunlar bir bayrakla işaretlenir. Böylece platformunuzun kataloğu, WGC tarafındaki değişikliklerle aynı hizada kalır.
2. Bir oyunu açmak. Bir oyuncu lobinizde bir oyun seçtiğinde sunucunuz API'den onu açmasını ister. İstek oyuncu kimliğini, para birimini, modu (gerçek veya demo) ve bir oyun numarasını taşır. Yanıt, oyuncunun tarayıcısının açacağı bir oyun başlatma bağlantısıdır; isterseniz bir çerçeve içinde. Bağlantıyı oyuncunun tarayıcısı açar; sunucunuz onu kendisi açmaz, yalnızca oyuncuya iletir. Açılmamış bağlantı beş dakika çalışır, açılmış bağlantı ise oyuncu aktif olduğu sürece çalışır.
3. Cüzdan. Oyun sırasında oyunun bir bakiyeye ihtiyacı vardır ve bahisleri ile kazançları kaydetmesi gerekir. Seamless wallet modelinde oyuncunun parası sizin platformunuzda kalır; bu yüzden API sizi çağırır: WGC, Callback URL'nize üç komutla imzalı istekler gönderir; biri bakiyeyi okumak, biri bir bahsi kazancıyla birlikte kaydetmek, biri de bir bahsi iptal etmek içindir. Yani bahisle ilgili para bilgisi her zaman sizin platformunuzdan gelir; WGC yalnızca sorar ve yanıtınızı kullanır. Bu, seamless wallet sayfasının konusudur.
4. Durum sorguları. Sonrasında platformunuz bir işlemin, bir turun veya bir oturumun akıbetini kendi numaralarını kullanarak sorabilir. Bir işlemin durumu kabul edildi, reddedildi, başarısız veya bilinmeyen gibi olabilir; bir tur ise bahsi, kazancı ve aradaki farkı bildirir.
Çağrıların iki yönü
Çağrıların iki yöne gittiğini düşünmek yardımcı olur. İlk yönde sunucunuz WGC'yi çağırır: kataloğu okur, oyun açar ve durumları sorgular. İkinci yönde WGC platformunuzu çağırır: bakiyeleri okur, bahisleri, kazançları ve iptalleri kaydeder. Her iki yön de aynı sözleşmenin parçasıdır ve bir entegrasyon, ancak ikisi de çalıştığında tamamlanmış sayılır.
İkinci yön daha katı kurallar taşır, çünkü para hareketi içerir. Her çağrı HMAC-SHA256 ve hesap sırrınızla imzalanır ve işleyiciniz imzayı ham gövde üzerinde, ayrıştırmadan önce doğrulamalıdır. WGC yanıtınız için üç saniye bekler. Bir bahis işlem kimliği başına yalnızca bir kez kaydedilir; böylece tekrarlanan bir çağrı oyuncunun hesabından iki kez düşmez ve döndürülen bakiyeyi de değiştirmez.
Bir tur nasıl ilerler
Tek bir oyunun yolu adım adım şöyledir.
- Platformunuz kataloğu senkronize etmiştir ve oyunları lobisinde gösterir.
- Oyuncu bir oyun seçer ve sunucunuz onu açmasını ister.
- WGC bir oyun başlatma bağlantısı döndürür ve oyuncunun tarayıcısı onu açar.
- Oyun bakiyeyi ister. WGC Callback URL'nizi çağırır, siz yanıtlarsınız ve oyun başlar.
- Her bahis için WGC sizi yine çağırır; bahsi ve genellikle aynı çağrıda kazancını gönderir.
- Yanıtınız zamanında ulaşmazsa bahis stüdyoya reddedilir, işlem bilinmeyen olur ve WGC daha sonra sizden bir rollback ile iptal etmenizi ister.
- Turdan sonra platformunuz işlemi, turu veya oturumu kendi numaralarıyla sorgulayabilir.
Bu yedi adım, her oyunda aynı şekilde tekrarlanır.
Bir casino API'sini kontrol etmek neden kolay olmalı
Teknik bir ekip, bir API'ye bağlanmadan önce onu değerlendirebilmelidir. WGC'de API'nin açıklaması herkese açıktır: bir OpenAPI dosyası ve bir dokümantasyon sayfası; ikisi de anahtar olmadan açılır. Farklıysa dosya doğrudur. API haber verilmeden bozulmaz: yeni alanlar görünebilir, bu yüzden tanımadıklarınızı yok sayarsınız; bir alan ise ancak kullanımdan kaldırma bildiriminden sonra ve en erken 90 gün sonra kaldırılır.
Sınırlar da yazılıdır. Varsayılan olarak bir anahtar dakikada 600 oyun açabilir; katalog ve durum istekleri için dakikada 120 istek izin verilir. Yöneticiniz, talep üzerine bir hesabın sınırlarını yükseltebilir.
Test için gerçek paraya gerek yoktur. Bir test anahtarı, Callback URL'nize gerçek çağrılar yapan bir test oyunu açar: WGC Test Slot. Back office'te entegrasyon kontrolü her çağrının canlı kaydını gösterir ve entegrasyon testi cüzdanınızın 14 kontrolünü çalıştırır. İşleyici örnekleri, bir kontrol betiği ve canlıya geçiş kontrol listesi herkese açıktır; bunların hepsini ekibiniz erişim almadan önce de okuyabilir. Daha fazlasını entegrasyon sayfasında ve demo ve test modunda okuyabilirsiniz.
Casino API'nin olmadığı şeyler
Casino API, oyuncular için bir casino değildir. WGC bir casino işletmez, oyuncu bakiyesi tutmaz ve oyuncu kaydı yapmaz: platformunuz kendi oyuncularını ve onların parasını tutar, yani oyuncularla olan ilişkiniz tamamen sizde kalır. Müşteri alanına erişimi bir yönetici kişisel olarak verir ve kendi kendine kayıt yoktur. Casino API ayrıca bir oyunun sonucuna dair bir vaat de değildir: seçilen bir RTP stüdyoya verilen bir ayardır ve her oyun onu kabul etmez.
Bu sınırlar baştan bilinirse entegrasyonun kapsamı da net olur. İsteklerin tam listesi ve birbirine nasıl oturduğu için Casino API genel bakışına bakın.