API Documentation

Xác Thực

POST

https://api.yourcasino.com/v1/auth/login

Đăng nhập để nhận Access Token

Yêu cầu (JSON)

{
  "username": "partner_username",
  "password": "your_secret_key"
}

Phản hồi thành công (200)

{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxxxxx",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Quản Lý Người Chơi

GET

https://api.yourcasino.com/v1/user/balance?user_id=12345

Lấy số dư tài khoản người chơi

Header yêu cầu

Authorization: Bearer <access_token>

Phản hồi (200)

{
  "user_id": 12345,
  "balance": 2850000,
  "currency": "VND",
  "locked_balance": 0,
  "updated_at": "2026-01-03T14:22:10Z"
}

Đặt Cược

POST

https://api.yourcasino.com/v1/bet/create

Tạo lệnh cược mới

Yêu cầu (JSON)

{
  "user_id": 12345,
  "game": "baccarat",
  "round_id": "BAC202601031456",
  "bet_amount": 200000,
  "bet_type": "player"
}

Phản hồi thành công (200)

{
  "success": true,
  "bet_id": "BET20260103001234",
  "new_balance": 2650000,
  "message": "Bet placed successfully"
}

Livestream Sảnh Game

GET

https://api.yourcasino.com/v1/stream/hall?hall=tx

Lấy link video livestream sảnh game (TX, Sexy AE, WM, DG, Evolution...)

Query Parameters

hall: string (required)
  Ví dụ: tx, socdia, sexy, wm, dg, evolution, ag, pp

Header yêu cầu

Authorization: Bearer <access_token>

Phản hồi (200)

{
  "hall": "tx",
  "stream_url": "https://live.txgaming.com/stream/hall1.m3u8",
  "backup_url": "https://backup.txgaming.com/stream/hall1.m3u8",
  "status": "online",
  "viewers": 1247,
  "updated_at": "2026-01-03T15:10:00Z"
}

Webhook Kết Quả

Hệ thống sẽ gửi kết quả ván chơi đến URL webhook mà bạn đã đăng ký.

URL webhook của bạn: https://yourdomain.com/api/casino/webhook

Dữ liệu gửi (POST JSON)

{
  "event": "game_result",
  "round_id": "BAC202601031456",
  "game": "baccarat",
  "result": "banker",
  "payout": 190000,
  "user_id": 12345,
  "bet_id": "BET20260103001234",
  "timestamp": "2026-01-03T14:25:45Z",
  "signature": "sha256=xxxxxxxxxx"
}

Lưu ý bảo mật

Sử dụng HTTPS cho tất cả request
Bảo mật API Key và Token tuyệt đối
Giới hạn rate: 120 request/phút/IP
Kiểm tra chữ ký (signature) cho webhook