Operatör API bağlantısı

#Nasıl çalışır?

Platform, iGaming desteği için sabit bir işlem kümesi tanımlar. Siz bu işlemleri kendi API’nizdeki uçlara eşlersiniz; her işlem bir yeteneğe (capability) bağlıdır ve yetenekler entegrasyon başına ayrı ayrı açılır. Tutarlar her zaman küçük birim (ör. kuruş) ve ISO 4217 para birimiyle taşınır.

Para ya da durum değiştiren tek işlem bonus.grant’tır. Ödeme bağlantısı para hareket ettirmediği için okuma sayılır; bağlantı adresi yapay zekâ modeline hiç verilmez, sohbete platform tarafından bir kart olarak eklenir.

#Kurulum adımları

Yönetim panelinde Entegrasyonlar sayfasından Yeni entegrasyon oluşturun (ad ve marka), ardından sihirbazın adımlarını izleyin. Değişiklik için integrations:write yetkisi gerekir.

1. API dokümanı

   OpenAPI 3.x (JSON veya YAML), Swagger 2.0 ya da Postman Collection v2.1 dosyası yükleyin; en fazla 5 MB. Harici $ref bağlantıları desteklenmez; belge tek dosya olmalıdır. Belge, ayrı ve yalıtılmış bir serviste ayrıştırılır.

2. Eşleme

   Yapay zekâyla öner taslak bir eşleme üretir: güven puanı, notlar, eşlenemeyen işlemler ve önerilen sunucular. Taslağı inceleyip düzenleyin ve kaydedin. Her işlem için yöntem, yol şablonu, girdi alanları, başarılı durum kodları, yanıt alanlarının yolları (ör. $.data.balance), dönüştürmeler (ör. ondalık tutarı küçük birime çevirme, değer eşleme, tarih biçimi) ve hata kuralları tanımlanır.

3. Sunucular ve kimlik bilgileri

   API’nin çağrılabileceği sunucuları tam host[:port] olarak girin (joker karakter yok, en fazla 10). Belgede veya öneride geçen sunucular listelenir ama hiçbiri kendiliğinden onaylanmaz. Ardından kimlik doğrulama türünü seçip değerleri girin (aşağıya bakın).

4. Uyumluluk

   Testler operatörünüzün test (sandbox) ortamına karşı çalışır. Var olan bir oyuncu kimliği ile var olmayan farklı bir kimlik girersiniz; bonus testi için isteğe bağlı kampanya, tutar ve para birimi. Testler her okuma yanıtının şemasını, aynı bonus isteğinin iki kez gönderilmesinde tek bonus tanımlandığını, zaman aşımı sonrası mutabakatı, hata eşlemesini ve gecikmeyi denetler.

5. Yayınlama ve yetenekler

   Yayınlamak için player.read yeteneğini kanıtlayan, başarılı bir uyumluluk çalıştırması gerekir. Yayınlanan sürümler değiştirilemez; değişiklikler yeni bir taslak ve yeni bir sürüm olarak yayınlanır. Yetenekler ayrıca açılır ve yalnızca testlerde kanıtlanan yetenekler açılabilir. bonus.grant için player.read ve restrictions.read da açık olmalıdır. Son olarak entegrasyonu etkinleştirin (kimlik bilgileri girilmiş olmalıdır).

Dene çalıştırıcısı ile eşlenmiş bir okuma işlemini taslak veya yayındaki sürüm üzerinde bir kez çağırıp sonucu görebilirsiniz; Sürümler sekmesi tanımlar arasındaki farkı gösterir.

#Kimlik bilgileri

Kimlik bilgileri bağlantı servisinin genel anahtarıyla şifrelenerek saklanır (RSA-OAEP-256 + A256GCM). Core API ve yönetim paneli bu değerleri çözemez; panelde yalnızca hangi alanların kayıtlı olduğu görünür. Değiştirmek için tüm değerleri yeniden girin.

#Ağ ve güvenlik kuralları

• Yalnızca izin verilen sunuculara ve yalnızca https üzerinden bağlanılır.
• Adres çözümlemesindeki tüm IP’ler genel internet adresi olmalıdır; özel ağ, loopback, link-local/metadata ve benzeri adresler engellenir. Bağlantı denetlenen IP’ye sabitlenir.
• URL içinde kimlik bilgisi kabul edilmez; yönlendirmeler izlenmez; yanıt en fazla 2 MB olabilir.
• Varsayılan zaman aşımı 8 saniyedir; işlem başına 0,5–30 saniye arasında ayarlanabilir. Okumalar en fazla 2 kez denenir; bonus.grant hiçbir zaman körlemesine yeniden gönderilmez.
• Art arda 5 hatadan sonra devre kesici 30 saniye boyunca yeni çağrıları durdurur.

#Oyuncu bağlama

Okuma işlemleri yalnızca imzalı kimlik token’ı ile doğrulanmış oyuncular için çalışır. Çağrıdaki oyuncu kimliği her zaman konuşmaya bağlı doğrulanmış oyuncunun kimliğiyle doldurulur. Sonuçlar kısa süre (30 saniye) önbelleğe alınır ve asistana doğrulanmış bilgi olarak verilir; asistan yalnızca bu verilerde yer alan tutarları söyleyebilir. Kart numarası, T.C. kimlik numarası ve IBAN gibi hassas veriler modele gönderilmeden önce maskelenir.

#Bonuslar, politika ve onay

Bonus tanımlama, yönetim panelindeki İşlem politikası ile yönetilir: bonusların açık olup olmadığı, oyuncunun widget’ta onaylaması, KYC şartı, belirli bir tutarın üzerinde insan onayı, bonus başına üst sınır, tenant’ın günlük toplamı, oyuncu başına günlük sınır ve yapay zekânın başlattığı istekler için ayrı günlük sınır, onay süreleri. Kampanyalar Bonus kampanyaları sayfasında tanımlanır.

Her bonus isteği sırasıyla şu denetimlerden geçer; ilk ret isteği durdurur:

1. oyuncu imzalı kimlikle doğrulanmış mı;
2. yetenek açık mı;
3. kısıtlamalar (ör. kendini dışlama; doğrulanamazsa reddedilir);
4. KYC (politika gerektiriyorsa);
5. kampanya etkin mi ve markayla uyumlu mu; kampanya kuralları;
6. operatörün uygunluk yanıtı (bonus.eligibility);
7. tutar ve sıklık sınırları; yinelenen istek denetimi.

Ardından oyuncu teklifi widget’ta onaylar (politika gerektiriyorsa). Tutar insan onayı eşiğinin üzerindeyse istek, actions:approve yetkisine sahip birinin onayına düşer; kimse kendi isteğini onaylayamaz ve politika onay anında yeniden değerlendirilir. Tanımlama tek seferlik bir idempotency anahtarıyla gönderilir. Sonuç belirsizse (zaman aşımı, bağlantı kopması) platform bonus.lookup ile mutabakat yapar. Oyuncuya yalnızca doğrulanmış başarıdan sonra bilgi verilir.

#İzleme

Operasyon ve olaylar bölümündeki Tanılama sekmesi entegrasyon çağrılarının kaydını (sonuç ve işleme göre filtrelenebilir) gösterir; hata oranı ve gecikme eşikleri aşıldığında olay (incident) açılır. Sağlayıcı çağrı kayıtları 30 gün sonra silinir.