Get started快速开始
Player launch flow玩家进入游戏流程
How a player goes from the merchant's site into a game table.玩家从商户站点进入游戏机台的完整流程。
Player Merchant site Platform API (us) Wallet API (merchant)
│ click game │ │ │
│─────────────►│ 1. issue a short-lived player token│ │
│ │ 2. POST /games/launch {token, …} ─►│ │
│ │ │ 3. POST /auth {token} ──────────────►│
│ │ │◄──── {extPlayerId, currency, balance}│
│ │ │ 4. create / load player, bind currency
│ │◄────────── {launchUrl, expiresAt} ─│ │
│◄─ redirect ──│ 5. redirect the player to launchUrl│ │
│──────────────────── open launchUrl (one-time) ───►│ │
│ … playing … │ debit / credit / rollback ──────────►│
- The launch URL is one-time and expires in 5 minutes. Redirect immediately; do not cache or forward it.
- One player has one active session per platform. A new launch closes the previous session.
- If
/authfails,games/launchreturns the reason (Launch a game); the player is not created.
- 进游戏地址只能用一次，5 分钟内有效。拿到后立即重定向，不要缓存或转发。
- 一个玩家在同一平台同时只有一个会话，新的进游戏会踢掉旧会话。
/auth失败时，games/launch返回原因（进游戏），不会建玩家。