Nexium Interactive API

Oyun listesi, launch URL, wallet ve callback — tek entegrasyon. Canlı base: https://api.nexiumapicasino.world/api/v1.

Base · api.nexiumapicasino.world/api/v1 Auth · Bearer site_key JSON · code / message / data

Kimlik doğrulama

Her istekte panelden aldığınız site API key’ini gönderin. Key’i tarayıcıya gömmeyin.

Header
Authorization: Bearer {site_api_key}
Accept: application/json
Content-Type: application/json

Cevap şekli

Tüm uçlar aynı zarfı kullanır. code === 0 başarıdır.

{
  "code": 0,
  "message": "OK",
  "data": { }
}

Canlı dene — Health

Bu sayfa canlı API’ye istek atar (auth gerekmez). Panel: panel.nexiumapicasino.world


      
GET /v1/health

Health

Servis ve bakım durumu. Auth yok.

Örnek cevap
{
  "code": 0,
  "message": "OK",
  "data": {
    "service": "Nexium Interactive",
    "status": "ok",
    "maintenance": false,
    "checks": { "database": true, "redis": true }
  }
}
Notlar
AlanAnlam
maintenancetrue ise launch/warm kapalı
statusok | maintenance | degraded
POST /v1/warm

Warm

Oyuncu lobideyken user map ısıtın. Launch’ta create atlanır.

Body
{ "username": "player1" }
data
{
  "warm": true,
  "user_code": 400040047,
  "created": false,
  "message": "MAP_HIT"
}
POST /v1/launch

Launch

Oyun URL üretir. provider_id + game_symbol ile oyunu başlatır.

Body
{
  "username": "player1",
  "game_symbol": "vs20olympgate",
  "provider_id": 1,
  "lang": "tr",
  "home_url": "https://yoursite.example/",
  "balance": 250.00
}
data
{
  "url": "https://…",
  "gplay_id": null,
  "warm": true,
  "launch_ms": 42
}
POST GET /v1/providers

Providers (Sağlayıcılar & Canlı Casino)

Size atanmış oyun sağlayıcılarını listeler. type parametresi ile "live" (Canlı Casino) veya "slot" (Slotlar) filtrelemesi yapabilirsiniz.

İstek Body (Opsiyonel Filtre)
{
  "type": "live"
}

Tüm sağlayıcıları almak için {} gönderin veya parametre vermeyin.

Örnek Yanıt
{
  "code": 0,
  "message": "OK",
  "data": {
    "providers": [
      { "code": "6", "name": "Evolution", "type": "live" },
      { "code": "10", "name": "Dream Gaming", "type": "live" },
      { "code": "11", "name": "Asia Gaming", "type": "live" },
      { "code": "1", "name": "Pragmatic Play", "type": "slot" }
    ]
  }
}
POST GET /v1/games

Games (Slot, Canlı Casino, Sanal Oyunlar [VIRTUALS] & Mini)

Oyun kataloğu listesi. Kategoriye ("Live", "Slots", "[VIRTUALS]" / "Virtuals", "Mini") veya sağlayıcı koduna ("provider_code") göre anlık filtrelenebilir. Görseller yüksek hızlı yerel CDN'den sunulur.

İstek (Sanal Oyunlar [VIRTUALS] Filtreleme)
{
  "category": "[VIRTUALS]"
}
İstek (Canlı Casino Filtreleme)
{
  "category": "Live",
  "provider_code": "6"
}
İstek (Slot Filtreleme)
{
  "category": "Slots",
  "provider_code": "1"
}
Image CDN URL
https://api.nexiumapicasino.world/assets/games/{provider}/{symbol}.webp
Örnek Yanıt (Canlı Oyun)
{
  "code": 0,
  "message": "OK",
  "data": {
    "games": [
      {
        "provider_code": "6",
        "provider_name": "Evolution",
        "provider_type": "live",
        "game_symbol": "crazytime",
        "game_name": "Crazy Time",
        "category": "Live",
        "type": "live",
        "game_image": "https://api.nexiumapicasino.world/assets/games/6/crazytime.webp",
        "launch_enable": true
      },
      {
        "provider_code": "6",
        "provider_name": "Evolution",
        "provider_type": "live",
        "game_symbol": "lightningroulette",
        "game_name": "Lightning Roulette",
        "category": "Live",
        "type": "live",
        "game_image": "https://api.nexiumapicasino.world/assets/games/6/lightningroulette.webp",
        "launch_enable": true
      }
    ]
  }
}

Canlı Casino Entegrasyonu & Özel Kurallar

Evolution, Dream Gaming ve Asia Gaming canlı masa ve şov oyunları doğrudan entegre edilmiştir.

Canlı Oyun Başlatma (Launch)
{
  "username": "player1",
  "game_symbol": "crazytime",
  "lang": "tr",
  "home_url": "https://yoursite.example/"
}

Canlı masalarda provider_id verilmesine gerek yoktur; sembolden (örn: crazytime) otomatik tespit edilir.

Canlı Bahis İptali / Rollback (cancel komutu)
{
  "command": "cancel",
  "user_code": "player1",
  "bet_trans_guid": "bet-guid-9812",
  "amount": 100.00,
  "game_type": "live",
  "round_id": "8472911"
}

Krupiye iptali veya tur geçersizliğinde callback adresinize command: "cancel" gelir. Bahis tutarını iade edip güncel bakiyeyi dönmelisiniz.

POST /v1/user

User

Kullanıcı oluştur / bilgi. username benzersiz olmalı.

{ "username": "player1" }
POST /v1/transactions

Transactions

Nexium ledger geçmişi (bet/win/deposit…).

POST /v1/wallet

Wallet balance

Bakiye sağlayıcı API’den okunur. Ekleme/çıkarma yoktur. Body: { "username": "player1" }

Wallet withdraw

{
  "username": "player1",
  "amount": 50,
  "trans_guid": "wd-unique-001"
}
POST /v1/bonus-call/start · /cancel

Bonus call (X)

Aktif oyun oturumu gerekir. gplay_id + set_point zorunlu (panel canlı listeden).

{
  "gplay_id": 19490613,
  "set_point": 1000,
  "memo": "",
  "username": "player1",
  "game_symbol": "vs20olympgate"
}
POST /v1/freespin/create · /cancel

Free spins

Promosyon freeround motoru. spins → rounds; ref = freeround referansı.

{
  "username": "player1",
  "game_symbol": "vs20olympgate",
  "provider_id": 1,
  "spins": 5,
  "bet_amount": 1
}

RTP (agent)

RTP oranları — ana admin panel: POST /panel-api/admin-ops/sites/{id}/rtp body { "rtp": 95 }.

POST /v1/callback/url

Callback URL Yönetimi

Sitenizin canlı callback adresini görüntüleme ve güncelleme.

{
  "callback_url": "https://yoursite.example/api/callback"
}

Callback Bildirimleri (Oyun Sunucusu → Siteniz)

Callback URL adresinize iletilen komutlar:

authenticate · balance · bet · win · cancel · status

Hata kodları

codeAnlam
0OK
40101TOKEN_INVALID
40202SITE_CREDIT_EMPTY
40301SITE_FROZEN
42200 / 42201PARAMETERS_INVALID
50002SITE_CONFIG_MISSING
50201PROVIDER_ERROR
50301PROVIDER_UNAVAILABLE
50310MAINTENANCE

Yönetimsel panel işlemleri için güvenlik kontrolleri ayrıdır.