Game Lobby

The Game Lobby endpoint is the entry point for launching DOWINN games within your platform. It generates a unique, authenticated game URL that can be embedded in your website using an iframe, opened in a new window, or used for direct navigation.

Tip

The returned game_url contains a session token that automatically authenticates the player, eliminating the need for separate login flows.

---

API Integration Examples

JavaScript Fetch

fetch('http://DOWINN-API/game-lobby', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'Api-Id': 'YOUR_SECRET_TOKEN',
  'Api-Key': 'YOUR_SECRET_TOKEN'
},
body: JSON.stringify({
  user_id: '',
  currency: 'KRW',
  language: 'EN',
  home_url: '',
  balance: 0,
  bet_n_min: 0,
  bet_n_max: 0
})
})

Axios

import axios from 'axios';

const options = {
method: 'POST',
url: 'http://API-PROVIDER/game-lobby',
headers: {
'Content-Type': 'application/json',
'Api-Id': 'YOUR_SECRET_TOKEN',
'Api-Key': 'YOUR_SECRET_TOKEN',
},
data: {
user_id: '',
currency: 'KRW',
language: 'EN',
home_url: '',
balance: 0,
bet_n_min: 0,
bet_n_max: 0
}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

---

Request Specification

Tip

The API provider handles all encryption, Base64 encoding, and MD5 hashing automatically. You don’t need to manually construct these parameters.

Headers

Header	Value	Description
Api-Id	agent_id	AL Agent
Api-Key	your_api_key	API KEY from us

Request Body Parameters

Parameter	Type	Required	Description
user_id	string	✅	Your player’s unique identifier
currency	string	✅	Game currency (KRW, USD, JPY, CNY, PHP, HKD, THB, VND, BDT, INR)
language	string	✅	Interface language (KO, EN, CN, JP)
bet_n_min	number	✅	Minimum bet for Natural (Banker/Player)
bet_n_max	number	✅	Maximum bet for Natural (Banker/Player)
home_url	string	❌	Return URL when player exits game

---

Response Body

200

Successful response

interface GameLobbyResponse {
  code: number
  data: {
    game_url: string
  }
}

The game_url is a fully authenticated link that:

• ✅ Automatically logs the player into the game
• ✅ Applies betting limits you specified
• ✅ Uses the language and currency settings
• ✅ Can be embedded via iframe or opened in a new window

202

Failed response

interface GameLobbyResponse {
  code: number
  message: string
}

500

Server error

interface GameLobbyResponse {
  code: number
  message: string
}

---

Integration Methods

Method 1: iFrame Embedding (Recommended)

Embed the game seamlessly within your platform:

<iframe
  src="{game_url}"
  width="100%"
  height="800px"
  frameborder="0"
  allow="fullscreen"
  style="border: none;"
></iframe>

Method 2: New Window/Tab

// Open in new window with specific dimensions
window.open(gameUrl, "dowinn_game", "width=1280,height=720");

// Or in new tab
window.open(gameUrl, "_blank");

Method 3: Full Page Redirect

window.location.href = gameUrl;

---

Sample Flow (Sequence Diagram)

---

What Happens Next?

After the player accesses the game_url:

1. Login Event Triggered - Your webhook receives a login command with the player’s user_id and feedback_data1
2. Balance Retrieved - Your server responds with the player’s current balance
3. Game Loads - Player sees the lobby with their balance displayed
4. Gameplay - Player can browse tables and start playing
5. Bet Events - Your webhook receives real-time bet/win/loss events
6. Logout Event - When player exits, you receive a logout command with final balance

Note

The feedback_data1 parameter is useful for tracking sessions, campaign IDs, or any custom metadata you need passed through to webhook events.

---

Common Use Cases

Use Case 1: Casino Platform Integration

Your Casino Website → Game Lobby API → game_url → Embed in iframe
Player plays without leaving your site

Use Case 2: Mobile App Integration

Mobile App → Game Lobby API → game_url → Open in WebView
Seamless in-app gaming experience

---

📌

For a comprehensive guide on how this works, please refer to the Common and Transfer Introduction or Seamless Introduction sections within the Introduction page.