游戏启动

获取游戏启动链接，玩家通过该链接进入真钱游戏。

接口信息

属性	值
路径	POST /papi/v1/game/launch
认证	Agent Token (Bearer)
Content-Type	application/x-www-form-urlencoded

请求参数

参数	类型	必填	说明
member_id	string	是	玩家唯一标识（代理侧 ID）
game_id	string	是	游戏 ID（来自游戏列表接口）
currency	string	是	货币代码（如 MYR、USD）。自动转为大写
platform	string	否	平台类型：WEB / MOBILE / DESKTOP，默认 WEB。自动转为大写
language	string	否	语言代码，默认 en-US
return_url	string	否	退出游戏后跳转的 URL

自动注册机制

玩家首次启动游戏时：

1. 系统会自动在游戏商注册玩家账号（无需单独调用）
2. 系统会自动为该币种创建 balance=0 的钱包（如尚不存在）

请求示例

curl -X POST https://api.example.com/papi/v1/game/launch \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=PLAYER_001&game_id=xxxx-guid&currency=MYR&platform=WEB&language=en-US"

响应字段

字段	类型	说明
game_url	string	游戏启动链接（将玩家跳转至此 URL 即可进入游戏）

响应示例

{
  "status": true,
  "code": 0,
  "data": {
    "game_url": "https://game.provider.com/play?token=xxx&lang=en-US"
  },
  "msg": "success"
}

错误码

错误码	Message	说明
1001	err.param.invalid	必填参数缺失（member_id、game_id、currency）
1002	err.signature.invalid	Agent Token 验证失败
2001	err.player.not_found	玩家不存在（需先注册）
4001	err.game.not_found	游戏不存在或已下线
4005	err.game.launch_failed	游戏启动失败（游戏商注册或内部错误）
4006	err.game.access_denied	代理未开通该游戏权限
5002	err.provider.call_failed	游戏商接口调用失败