游戏启动（试玩）

获取试玩游戏链接，无需玩家注册或真钱账号。

接口信息

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

请求参数

参数	类型	必填	说明
game_id	string	是	游戏 ID（来自游戏列表接口，使用 game_id 字段）
currency	string	是	货币代码（如 MYR、USD）。自动转为大写
platform	string	否	平台类型：WEB / MOBILE / DESKTOP，默认 WEB。自动转为大写
language	string	否	语言代码，默认 en-US

请求示例

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

响应字段

字段	类型	说明
game_url	string	试玩游戏链接

响应示例

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

错误码

错误码	Message	说明
1001	err.param.invalid	必填参数缺失（game_id、currency）
1002	err.signature.invalid	Agent Token 验证失败
4001	err.game.not_found	游戏不存在或已下线
4005	err.game.launch_failed	游戏启动失败
5002	err.provider.call_failed	游戏商接口调用失败