#玩遊戲URL和參數
本文檔概述了存取和導航遊戲相關頁面(包括大廳和遊戲室)所需的URL 結構和查詢參數。
#目錄
#1. 基礎URL
#baseUrl
- 描述: 遊戲平台的根URL,它是所有遊戲相關端點的基礎。
該值因環境(生產、暫存)而異。 - 類型:
String (URL) - 必填: ✅ 是
#2. URL 查詢參數
查詢參數附加到基本 URL 以為遊戲相關請求提供附加上下文或配置。
這些參數對於身份驗證、導航和定位至關重要。
#token
- 描述: JWT 用於驗證使用者身分並授權存取遊戲頁面。
- 類型:
String - 必填: ✅ 是
- 範例:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
#returnUrl
- 描述: URL 指定使用者點擊側邊選單中的「首頁」按鈕時應重定向到的位置。
- 類型:
String (URL) - 必填: ❌ 否
- 範例:
https://domain.com/home
#ccy
- 描述: 指定遊戲內交易或顯示的貨幣。
- 類型: 支援的貨幣
- 必填: ❌ 否
- 預設:
USDT
#lang
- 描述: 設定遊戲平台的使用者介面語言(在地化)。
- 類型: 支援的語言
- 必填: ❌ 否
- 預設:
en(英文)
#3. 頁面特定的 URL 格式
以下部分描述了用於訪問大廳頁面和個人遊戲室的URL結構。
#3.1。移動大廳頁面
URL 格式:
{baseUrl}/m/main/home描述: 此端點呈現主大廳介面,顯示可用的遊戲室。
支援的查詢參數: 以上所列的所有參數(
token、returnUrl、ccy、lang)。範例(包含所有參數):
{baseUrl}/m/main/home?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...&returnUrl=https%3A%2F%2Fgameplatform.com%2Fhome&ccy=USD&lang=en
#3.2。手機遊戲室
- URL 格式:
{baseUrl}/m/live-games/{gameType}/{roomId} - 描述: 加載特定的遊戲室,用戶可以在其中參與即時遊戲。
#參數
| 名稱 | 類型 | 必填 | 描述 | 範例/支援的值 |
|---|---|---|---|---|
gameType |
字串 | ✅ 是的 | 指定要玩的遊戲類型。 | 支援:bcr(百家樂) |
roomId |
字串 | ✅ 是的 | 特定遊戲室實例的唯一識別碼。 | 可用房間ID |
#查詢參數
支援所有全域查詢參數(token、returnUrl、ccy、lang)。
- 範例(包含所有參數):
{baseUrl}/m/live-games/bcr/684bf6dfbd4840601505f574?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...&returnUrl=https%3A%2F%domain.com%2Fhome&ccy=USD&lang=en
#3.3。 Web 大廳頁面
URL 格式:
{baseUrl}/w/main/home描述: 此端點呈現主大廳介面,顯示可用的遊戲室。
支援的查詢參數: 以上所列的所有參數(
token、returnUrl、ccy、lang)。範例(包含所有參數):
{baseUrl}/w/main/home?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...&returnUrl=https%3A%2F%2Fgameplatform.com%2Fhome&ccy=USD&lang=en
#3.4。 Web遊戲室
- URL 格式:
{baseUrl}/w/live-games/{gameType}/{roomId} - 描述: 加載特定的遊戲室,用戶可以在其中參與即時遊戲。
#參數
| 名稱 | 類型 | 必填 | 描述 | 範例/支援的值 |
|---|---|---|---|---|
gameType |
字串 | ✅ 是的 | 指定要玩的遊戲類型。 | 支援:bcr(百家樂) |
roomId |
字串 | ✅ 是的 | 特定遊戲室實例的唯一識別碼。 | 684bf6dfbd4840601505f574 |
#查詢參數
支援所有全域查詢參數(token、returnUrl、ccy、lang)。
- 範例(包含所有參數):
{baseUrl}/w/live-games/bcr/684bf6dfbd4840601505f574?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...&returnUrl=https%3A%2F%domain.com%2Fhome&ccy=USD&lang=en