2.3 登录

POST /api/v1/user/exchange/sso/getkey

无需另外为玩家创建会员账号。直接调用登录 API 即可，系统会自动判断：若该玩家为首次登录，将自动完成账号创建；已有账号则直接登录。

请求 Body（JSON）

字段	必填	类型	说明
external_player_id	TRUE	string	玩家 ID（商户侧），最长 128 字符，支持大写英文；各环境（测试 / 正式）的玩家数据各自独立
player_name	TRUE	string	玩家名称（商户侧），最长 64 字符；允许重复
currency_code	TRUE	string	玩家账户货币代码，支持币种见 币种文档
lang	FALSE	string	游戏界面初始语言，zh（简体中文）、en（英文）或 vi（越南语）；未传入时跟随浏览器语言，不支持的语言一律回退为英文；玩家进入后仍可在界面自行切换

{
  "external_player_id": "player1",
  "player_name": "player1_name",
  "currency_code": "CNY",
  "lang": "zh"
}

响应 data

{
  "code": 0,
  "message": "success",
  "data": {
    "temporary_key": "sso_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "redirect_url": "https://bfxdemo.com#/launch?key=...&redirect=exchange&lang=zh",
    "expires_in": "600",
    "currency_code": "EUR"
  }
}

取得 redirect_url 后即可直接跳转到游戏页面。expires_in 单位为秒。