iGaming API Dokümantasyonu ve Entegrasyonlar

Geliştiriciler

API Dokümantasyonu

RESTful API, WebSocket bildirimleri ve sandbox test ortamı.

RESTful API

Kullanıcı yönetimi, oyun oturumları, para yatırma/çekme. Tüm endpoint'ler JSON.

WebSocket

Anlık bildirimler. Bakiye güncellemeleri, oyun sonuçları gerçek zamanlı iletilir.

Sandbox Ortamı

Test verileriyle güvenli geliştirme. Canlıya geçmeden önce tüm akışı test et.

Endpoint Örnekleri

POST/api/v1/usersYeni kullanıcı oluştur

GET/api/v1/users/{id}Kullanıcı bilgisi

PUT/api/v1/users/{id}/balanceBakiye güncelle

POST/api/v1/users/{id}/sessionOturum başlat

const res = await fetch(
  'https://api.softagon.net/v1/users',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      username: 'player123',
      currency: 'EUR',
      country: 'DE'
    })
  }
);
const user = await res.json();

Oyun Endpoint'leri

GET/api/v1/gamesTüm oyunları listele

GET/api/v1/games/{id}Oyun detayı

POST/api/v1/games/{id}/launchOyun oturumu başlat

GET/api/v1/providersSağlayıcıları listele

const res = await fetch(
  'https://api.softagon.net/v1/games/12345/launch',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      user_id: 'usr_abc123',
      currency: 'EUR'
    })
  }
);
const { game_url } = await res.json();

Ödeme Endpoint'leri

POST/api/v1/payments/depositPara yatırma

POST/api/v1/payments/withdrawPara çekme

GET/api/v1/payments/{id}/statusİşlem durumu

GET/api/v1/payments/methodsYöntemleri listele

const res = await fetch(
  'https://api.softagon.net/v1/payments/deposit',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      user_id: 'usr_abc123',
      amount: 100.00,
      currency: 'EUR',
      method: 'visa'
    })
  }
);
const { payment_url } = await res.json();

WebSocket Bildirimleri

EVTbalance.updateBakiye değişikliği

EVTgame.resultOyun sonucu

EVTpayment.completedÖdeme tamamlandı

EVTuser.sessionOturum durumu

const ws = new WebSocket(
  'wss://ws.softagon.net/v1/stream'
);

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'auth',
    api_key: 'YOUR_KEY'
  }));
};

ws.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log(data.type, data.payload);
};

API Anahtarı Al →

Detay

Hata Kodları & En İyi Pratikler

Entegrasyon sırasında en sık görülen senaryolar ve önerilen çözüm adımları.

Kod	Anlam	Öneri
AUTH_401	Yetkisiz istek / geçersiz anahtar	API key ve IP whitelist kontrol edin
RATE_429	Hız limiti aşıldı	Retry/backoff uygulayın, batch kullanın
WALLET_409	İşlem tekrarlandı / idempotency çakışması	Transaction ID benzersiz olmalı
SESSION_410	Oturum süresi doldu	Yeni session üretip oyunu yeniden açın
PROV_503	Sağlayıcı geçici olarak erişilemiyor	Fallback sağlayıcı/oyun akışı gösterin
CONFIG_422	Eksik/uyumsuz konfigürasyon	Merchant/provider ayarlarını kontrol edin
TIMEOUT_504	Upstream timeout	Retry/backoff uygulayın, status endpoint ile doğrulayın

Idempotency

Ödeme ve wallet endpoint'lerinde aynı işlem iki kez uygulanmaz. Transaction ID stratejisi kritik.

Güvenlik

HTTPS zorunlu, anahtar rotasyonu ve en az yetki prensibi ile erişim yönetimi.

Webhook

Ödeme ve oyun event'leri için doğrulama imzası kullanın, retry ve timeout politikası belirleyin.

{
  "id": "evt_01HXYZ...",
  "type": "payment.succeeded",
  "created_at": "2026-01-01T12:34:56Z",
  "data": {
    "merchant_id": "m_123",
    "tx_id": "tx_789",
    "amount": 100.00,
    "currency": "EUR",
    "status": "succeeded"
  }
}

SSS

Geliştirici SSS

Sandbox, anahtar ve entegrasyon akışı hakkında kısa yanıtlar.

Sandbox test verileri ile çalışır ve finansal etkisi yoktur. Canlı ortamda gerçek ödeme ve sağlayıcı akışları devreye alınır.

İmza header'ı ile payload hash'i eşleştirilir. Hatalı imza durumunda istek reddedilir ve loglanır.

Exponential backoff ile retry uygulayın. Mümkünse katalog/rapor isteklerini batch veya cache üzerinden yönetin.

Session TTL, kullanıcı logout veya sağlayıcı taraflı timeout ile kapanabilir. Yeni session üretip kullanıcıyı tekrar oyuna yönlendirin.

Harekete Geç →

Softagon ile yayına çıkın

Casino ve sportsbook operasyonları için altyapı, entegrasyon ve back-office yönetimini tek panelde yönetin.

API'yi İncele Teklif Al