Common API Introduction

How This API Works

API server (DOWINN) provides a simplified wrapper API that handles all the complex encryption, encoding, and hashing processes for you. You just need to send straightforward requests with your credentials and data.

---

Example Endpoint

• Route: /game-lobby
• Method: POST

---

Request Specification

Tip

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

Headers

Name	Type	Required	Description
Api-Id	string	✅	Your agent identifier
Api-Key	string	✅	Your secret key

Request Body

Property	Type	Required	Description
user_id	string	✅	Unique user identifier
agent_id	string	✅	Agent identifier
balance	number	✅	User’s current balance
currency	string	✅	Example: KRW, USD, JPY, CNY, PHP, HKD, THB, VND, BDT, INR
language	string	✅	Example: KO = Korean, EN = English, CN = Chinese, JP = Japanese
home_url	string	❌	URL to return after game session
table_code	string	❌	Specific table code (if applicable)
bet_n_min	number	✅	Minimum bet amount (Normal)
bet_n_max	number	✅	Maximum bet amount (Normal)

Sample Request

headers
POST /game-lobby
Content-Type: application/json
Api-Id: your-agent-id
Api-Key: your-secret-key

body
{
  "user_id": "karlphp01",
  "agent_id": "your-agent-id",
  "balance": 0,
  "currency": "PHP",
  "language": "EN",
  "home_url": "",
  "table_code": "",
  "bet_n_min": 100,
  "bet_n_max": 1000000
}

Response Interface

interface IGameLobby {
  code: number
  response_data: {
    game_url: string
  }
}

Sample Response

{
  "code": 0,
  "response_data": {
    "game_url": "https://game_url.com/api/game_lobby/?token=eyJhbGciOiJIUzI1NiIs..."
  }
}

Note

Code 0 indicates a successful request. Other codes represent various error conditions.

Response Codes

{
  "https": {
    "200": "successful request",
    "202": "failed request",
    "500": "internal error"
  },
  "codes": {
    "0": "successful request",
    "1": "error occured",
    "2": "missing data",
    "3": "invalid key",
    "4": "data format error",
    "5": "expired request",
    "6": "invalid agent",
    "9": "blocked user",
    "100": "data value error",
    "101": "permission denied",
    "102": "insufficient balance",
    "103": "integration failure"
  },
  "history_types": {
    "ALL": "all",
    "END": "ended",
    "ING": "ongoing"
  }
}

Making a Request

Sample Code (Node.js)

const axios = require('axios');

const headers = {
  'Content-Type': 'application/json',
  'Api-Id': 'your-agent-id',
  'Api-Key': 'your-secret-key',
};

const body = {
  user_id: 'testuserid',
  agent_id: 'your-agent-id',
  balance: 0,
  currency: 'PHP',
  language: 'EN',
  home_url: '',
  table_code: '',
  bet_n_min: 100,
  bet_n_max: 1000000
};

try {

  const response = await axios.post(
    'https://DOWINN-API/game-lobby',
    body,
    { headers }
  );

  console.log(response.data);
  /*
  {
    "code": 0,
    "response_data": {
      "game_url": "https://game_url.com/api/game_lobby/?token=eyJhbGciOiJIUzI1NiIs..."
    }
  }
  */
} catch (error) {
  console.error('Error:', error.response?.data || error.message);
}

---

What Happens Behind the Scenes

Note

The DOWINN wrapper automatically handles all the complex processes:

1. Formats your data into key=value pairs
2. Base64 encodes the formatted data
3. Generates Unix timestamp
4. Creates MD5 hash from: api-id + timestamp + api-key + base64-data
5. Constructs the final request to the game server
6. Returns the simplified response

You don’t need to do any of this manually!

---

Tip

• Make sure your credentials (Api-Id, Api-Key) are correct
• The wrapper URL should be provided by DOWINN support
• All encryption and hashing is handled automatically by the wrapper
• You can focus on your business logic instead of complex API authentication

---

Next Steps

Choose your integration type:

• Transfer Integration - You control deposits/withdrawals
• Seamless Integration - Real-time webhooks