Oturum isteği
Sunucunuz bir oyuncu için bir oyunu POST /v1/sessions ile açar. Çağrı sunucudan sunucuyadır: anahtar X-API-Key başlığında gider ve tarayıcı API'yi hiçbir zaman çağırmaz.
POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}
→ 200 { "ok": true, "requestId": "req_…", "data": { "url": "https://play.worldgamingconnect.com/play/Zk3p9xQ2vL8mTn4r", "sessionId": "cmgq3r8v40001l8xyz5k2abcd", "expiresAt": "2026-10-12T10:45:00.000Z" } }Zorunlu alanlar playerId, currency, mode ve publicId ya da universalId alanlarından tam olarak biridir. Oyuncu numarası 1 ile 64 arasında yazdırılabilir ASCII karakterdir ve kendi sisteminizdeki bir oyuncuyu adlandırır: WGC hiçbir oyuncu oluşturmaz; çünkü cüzdan casino'nuzda kalır. Para birimi 3 ile 8 harf arasında bir koddur ve mod real ya da demo olur. İsteğe bağlı alanlar dili, dönüş adresini, platformu (masaüstü ya da mobil), oyuncunun ülkesini, kendi oturum numaranızı ve bunları kabul eden oyunlar için RTP ile bahis limitlerini belirler.
Yanıtta ne vardır
url başlatma bağlantısıdır, sessionId oturumun casino'nuzun göreceği numarasıdır ve expiresAt, açılmamış bir bağlantının çalıştığı son zamandır. Oturum numarasını saklayın: oturumu daha sonra sorgulamak için kullandığınız numara ve raporlardaki numara odur. Oturum numarasını, oyuncu ve oyun bilgisiyle birlikte kendi kayıtlarınıza yazmak, bir destek talebinde ilgili oturumu hemen bulmanızı sağlar.
Bağlantıyı oyuncunun tarayıcısında açın
Bağlantı WGC'nin kendi adresidir ve oyuncunun tarayıcısında açılmalıdır: sayfayı ona yönlendirerek ya da bir frame içine koyarak. Onu sunucunuzdan çağırmayın. Bağlantı, onu açan cihazı kaydeder ve sunucunuzdan yapılan bir çağrı oyuncunun açılışı olarak kaydedilirdi. Bu yüzden sunucunuz yalnızca bağlantıyı alır ve oyuncuya iletir; açma işini tarayıcı yapar.
Bağlantı ne kadar yaşar
- Hiçbir tarayıcının açmadığı bağlantı 5 dakika çalışır. Daha sonra açmak için yeni bir oturum isteğiyle yeni bir bağlantı isteyin.
- Oyuncunun tarayıcısı bir kez açtıktan sonra bağlantı, oyuncu oynadığı sürece, yani cüzdan çağrıları geldiği sürece yaşar.
- Oturum kapandıktan sonra bağlantı, açık bir sayfayla ve 410 durumuyla yanıt verir. Yeniden oynamak için oyun, yeni bir oturum isteğiyle lobinizden tekrar açılır. Oyuncu eski bir bağlantıyı bir yer imine kaydettiyse de aynı sayfayı görür; bu bir hata değil, oturumun bittiğinin açık bir göstergesidir.
Bağlantıyı bir frame içine koyun
Bağlantı, allow="fullscreen; autoplay" ile bir <iframe> içine konabilir. En az allow-scripts allow-same-origin allow-popups taşımıyorsa bir sandbox özniteliği eklemeyin; çünkü daha sıkı bir sandbox oyunun çalışmasını engeller. Bazı oyunlarda bağlantı bir kez çalışır: yeni bir sekmede yenileme, onun ikinci bir açılışıdır. Bu olduğunda oturum isteğini yeniden yapın ve yeni bağlantıyı açın; bu, taze bir oyun adresine sahip aynı oturumdur. Oyun bir frame içinde boş kalıyor ama yeni bir sekmede açılıyorsa, oyunu ve alan adınızı belirterek canlı destek'e yazın.
Dönüş adresi ve dil
returnUrl, oyun bittiğinde oyuncuyu lobinize geri getirir. Onsuz WGC nötr bir sayfa gösterir. Her oyun bir dönüş adresi kabul etmez ve oyun içi lobi her stüdyoda çalışmaz; bu yüzden kendi sayfanızda oyunculara frame'den çıkmanın bir yolunu verin.
Dil, ISO 639-1 kodudur. pt-BR gibi bir bölgeye izin verilir ve bölge kesilir. Dil yerine gönderilen bir ülke kodu değiştirilir; yani ua, uk olur. Bilinmeyen bir kod İngilizceye döner ve oyun hiçbir zaman dil yüzünden reddedilmez. Oyunun gerçekte ne göstereceği stüdyoya bağlıdır; bu yüzden bir dilin gösterildiğini bir söz olarak okumayın ve önemli dil kombinasyonlarını kendiniz kontrol edin.
Oyuncu ve oyun başına bir açık oturum
Bir oturum açıkken, aynı oyuncu, oyun, para birimi ve mod için ikinci bir istek o oturumu ve aynı başlatma bağlantısını döndürür. Aynı anda yapılan iki açılış, örneğin çift tıklama, ikisi de aynı oturumla yanıt verir ve ilkinin henüz bağlantısı yoksa diğeri try_later yanıtı verir. Farklı bir oyuncu, para birimi ya da mod farklı bir oturumdur. Oturum kapandıktan sonra bir sonraki açılış yenisini oluşturur.
İsteğe bağlı Idempotency-Key başlığı, 24 saat geçerlidir ve tekrarlanan bir isteği güvenli kılar: aynı anahtar ve aynı gövde, stüdyoya yeni bir çağrı yapılmadan aynı yanıtı döndürür; farklı bir gövde ise invalid_request olur. Bir anahtar, süresi dolmuş bir bağlantıyı yenilemez: expiresAt sonrasında oturumu yeni bir anahtarla açın. Bu iki kural birlikte, çift tıklama ve ağ tekrarları gibi durumların oyuncu için yinelenen oturumlara yol açmasını önler.
Beklenecek retler
error.code | HTTP | Ne yapılmalı |
|---|---|---|
unauthorized | 401 | Anahtarı kontrol edin. |
invalid_request | 400 | Mesajda adı geçen alanı düzeltin. Canlı anahtarla bir demo açılışı da reddedilir. |
not_found | 404 | Oyun yok, hesabınıza verilmemiş ya da hesabınız için fiyatlandırılmamış. Yoklamayın. |
currency_not_granted | 400 | Para birimi hesabınıza verilmemiş. |
balance_required | 402 | Gerçek bir oturum, hesapta para gerektirir. Yükleme yapın ya da bir test anahtarıyla demo açın. |
country_restricted | 403 | Stüdyo, oyunu oyuncunun ülkesinde yasaklıyor. Başka bir oyun önerin. |
rate_limited | 429 | Retry-After içindeki saniye kadar bekleyin. |
try_later | 409 | Bu anahtarla yapılan önceki açılış hâlâ sürüyor. Bir saniye sonra yeniden deneyin. |
busy | 503 | WGC yük altında; Retry-After sonrasında yeniden deneyin. |
Yalnızca error.code üzerinden dallanın; mesaj insanlar içindir. Her ret için platformunuzda oyuncuya gösterilecek kısa bir metin ve kendi günlüğünüzde tutulacak kodu önceden belirleyin; böylece bir ret, oyuncuda belirsizlik yaratmadan ve ekibiniz için izlenebilir biçimde karşılanır. Bir para biriminde kullanılamayan oyun katalogda işaretlenir ve o para biriminde başlatma reddedilirken diğer para birimleri çalışmaya devam eder. Gerçek bir başlatma, ticari hesabınızda para olmasını gerektirir: bakiye artı kredi limiti sıfırın üzerinde olmalıdır; demo başlatma ise para hareket ettirmez. Oturum açma, anahtar başına sınırlıdır ve varsayılan dakikada 600'dür.
Bir oturumu sonra okumak
Sunucunuz bir oturumu numarasıyla GET /v1/sessions/{sessionId} ile okuyabilir; bu çağrı durumunu, para birimini, modu ve toplamları gösterir. Kendi numaranızla GET /v1/sessions?casinoSessionId= ile oturumlarınızı da bulabilirsiniz. Yalnızca hesabınızın oturumları görünür. Destek taleplerinde oturum numarasını, istek numarasını ve UTC saatini belirtin. Bir turun içinde neler olduğu için tur akışına, tekrarlar için idempotency yazısına bakın.
Başlatmadan sonra gelen çağrılar için Casino API genel bakışına, entegrasyon adımlarına, demo ve test moduna ve seamless wallet sayfasına bakın.