Oyun platformları için casino API entegrasyonu

WGC casino API'si, operatörler için sunucudan sunucuya bir arayüzdür. Platformunuz bu arayüz üzerinden hesabına verilen oyun kataloğunu alır, oyuncular için oyun açar, cüzdan çağrılarını yanıtlar ve kendi işlemlerinin durumunu okur. Bu sayfa, nasıl çalıştığını özetler; canlıya geçiş adımları entegrasyon sayfasındadır. Aşağıda önce kimlik doğrulamayı, sonra oyunları, cüzdanı ve sınırları bulacaksınız.

Tek zarf, tek anahtar

Sunucunuz API'yi X-API-Key başlığındaki bir anahtarla çağırır. Her yanıt, bir ok bayrağı, bir istek kimliği ve ya veri ya da hata içeren aynı zarfı kullanır. Kodunuzu yalnızca hata koduna göre dallandırın; mesaj insanlar için yazılmıştır. API tarayıcılar için tasarlanmamıştır ve çapraz kaynak çağrılarını desteklemez; yani anahtarınız hiçbir zaman tarayıcıya gitmez, çağrıları yalnızca sunucunuz yapar.

Anahtarları back office'te kendiniz oluşturur ve iptal edersiniz: en fazla beş canlı ve en fazla iki test anahtarı, değer bir kez gösterilir. Gerçek trafiği olan bir hesapta yeni bir canlı anahtar 30 dakika sonra, ya da ikinci bir kişi onayladığı anda hemen yanıt vermeye başlar.

Neler çalışıyor

Çalışan yöntemler şunlardır: anahtar gerektirmeyen bir sağlık kontrolü, oyun kataloğu, oturum açma, kendi numaralarınızla üç durum sorgusu (bir işlem, bir tur ve bir oturum), kendi oturum kimliğinizle oturum sorgusu, kazanç limitleri ve WGC'nin platformunuza yaptığı cüzdan çağrıları. Makine tarafından okunabilir açıklama anahtarsız açılan bir OpenAPI 3.1 dosyasıdır; okunabilir açıklama ise herkese açık bir dokümantasyon sayfasıdır. İkisi farklıysa dosya doğrudur; bu yüzden entegrasyonunuzu yazarken ayrıntılar için dosyaya güvenin.

Oyunlar ve oturumlar

Oyun isteği, hesabınıza verilen oyunları sayfa başına 200 olarak döndürür; her birinde bir publicId, bir universalId, bir tür, bir görsel adresi ve yetenek bayrakları bulunur. İlk tam indirmeden sonra, son senkronizasyon zamanınızı göndererek yalnızca değişiklikleri istersiniz. Katalog ayrıntıları için oyun agregatörü genel bakışına ve slot API sayfasına bakın.

Bir oturum isteği; oyuncu kimliğini, para birimini, modu (gerçek veya demo) ve tek bir oyun numarasını gerektirir. Dili, bir dönüş adresini, platformu, oyuncunun ülkesini, kendi oturum kimliğinizi ve bunları kabul eden oyunlar için 75 ile 96 arasında bir RTP ile bahis limitlerini ekleyebilirsiniz. 24 saat geçerli bir idempotency anahtarı, aynı istek için aynı yanıtı döndürür; aynı oyuncu ve oyun için tekrarlanan bir açma isteği de oturum açık olduğu sürece aynı oturumu döndürür.

Cüzdan ve durum sorguları

Oyuncu bakiyeleri platformunuzda kalır; yani oyuncunun parasını WGC değil, siz tutarsınız. WGC, bakiye, bir bahis ve kazancı ve bir rollback için imzalı istekleri Callback URL'nize yapar; sözleşme seamless wallet entegrasyonu sayfasında anlatılır. Sonrasında bir işlemin, bir turun veya bir oturumun durumunu kendi numaralarınızla okuyabilirsiniz. API isteklerinizin kaydı 90 gün saklanır.

Ücretsiz döndürme

Bir oyuncu için ücretsiz döndürme API üzerinden verilebilir, ancak özellik varsayılan olarak kapalıdır ve talebiniz üzerine açılır. Her oyunda çalışmaz ve bonus bir bahis gibi ödenir. Projenize uyup uymadığını yöneticinize sorun; açılmasına birlikte karar verirsiniz.

Kazanç limitleri ve RTP

Kazanç limitleri uygun yetkiyle API üzerinden okunabilir ve değiştirilebilir; back office'te ise şüpheli kazançlar için durdurma çizgileri koyarsınız: tek bir kazanç, bir oyuncunun bir saatteki kazançları ve bir hesabın bir saatteki kazançları; hepsi platformun sınırları içinde. Bir başlatma için RTP ve bahis limitleri, bunları destekleyen oyunlarda istekte veya back office'te ayarlanır.

Sınırlar ve kararlılık

Varsayılan olarak bir anahtar dakikada 600 oyun açabilir; katalog ve durum istekleri için dakikada 120 istek izin verilir. Tek bir adresten gelen ani artışlar sınırlanır ve aşım, bir bekleme süresiyle birlikte bir hız sınırı yanıtı alır. Yöneticiniz bir hesabın sınırlarını yükseltebilir; bunu kendi hesabınız için talep edebilirsiniz. Talep üzerine hesabınızın çağrıları, en fazla 50 girişlik bir adres listesiyle de kısıtlanabilir.

API'nin bir sürümü haber verilmeden bozulmaz. Yeni alanlar görünebilir; bu yüzden tanımadığınız alanları yok sayın. Bir alan ancak kullanımdan kaldırma bildiriminden sonra ve en erken 90 gün sonra kaldırılır veya anlamı değiştirilir. Uyumsuz bir değişiklik yeni bir sürüm olurdu ve mevcut sürüm yanında çalışmaya devam eder.

Önce deneyin

Bir test anahtarı, Callback URL'nize para olmadan gerçek çağrılar yapan bir test oyunu açar; böylece canlıya geçmeden önce tüm yolu deneyebilirsiniz. Demo ve test modu sayfasına, para birimi kuralları için para birimleri sayfasına ve entegrasyon adımlarına bakın.

SSS

Herkese açık bir API açıklaması var mı?

Evet: bir OpenAPI 3.1 dosyası ve bir dokümantasyon sayfası; ikisi de anahtarsız açılır.

API'yi bir tarayıcıdan çağırabilir miyim?

Hayır. Sunucudan sunucuya bir API'dir.

Anahtarı nasıl alırım?

Yöneticinizin sizin için açtığı back office'ten kendiniz oluşturursunuz.

Entegre etmeye hazır mısınız? Entegrasyonu görüşelim.

Bir sonraki bağlantınız
burada başlar.

Ne kurduğunuzu anlatın. Gerisini biz üstlenelim.

Görüşelim