Skip to content
v1.0.0 (2026-08-15 18:56)

玩家退出游戏 (Exit Game) ✓ 已完成

概述

  • 接口说明:玩家在游戏内点击"返回大厅/退出游戏"或关闭游戏页面时调用,后端会通知 Hub 踢出玩家并释放本地游戏锁。

调用关系说明

NOTE

退出游戏接口内部调用 Hub 的 /papi/v1/player/reclaim 完成踢出与余额回收,member_id 传玩家原生用户名(username,与游戏启动接口 /papi/v1/game/launch 一致);Hub 回收成功后清零玩家活跃钱包余额并触发 /settle 回调退回资金,随后回调包网的 /api/v1/callback/offline 通知下线(记录游玩日志),玩家无需关心这些回调。


1. POST - 退出游戏

  • 路径: /client/games/exit

请求 Header

参数名类型必填说明
AuthorizationStringBearer Token(玩家 JWT,必须已登录)

请求参数

无(玩家身份从 JWT 获取)

响应示例

json
{
  "status": true,
  "code": 0,
  "data": null,
  "msg": "Success"
}

NOTE

退出成功不返回玩家余额;玩家退出后的最终余额请调用 GET /client/member/getBalance 获取。Hub 回收金额(reclaimed_amount)仅由后端用于对账审计。

错误响应示例

json
{
  "status": false,
  "code": 7,
  "data": {},
  "msg": "退出游戏失败,请稍后再试"
}

NOTE

msg 会根据玩家语言自动返回(优先取 JWT 的 language claim、x-language 请求头或玩家档案语言),以上为中文(zh_cn)示例。