#玩游戏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