玩家强行踢线

下游商户在玩家登出或封禁账号时调用此接口。网关会更新本地玩家状态为 Inactive（禁用），并逐个向各游戏商发起强行踢线请求，断开玩家在大厅内的连接。

接口信息

属性	值
路径	POST /papi/v1/player/logout
认证	Agent Token（Bearer）
Content-Type	application/x-www-form-urlencoded

请求头

Header	值	必填
Authorization	Bearer {agent_token}	✅ 必填

请求参数

参数名	类型	必填	说明
member_id	string	是	玩家在下游商户侧的唯一账号标识（系统会自动转大写处理）

请求示例

curl -X POST https://api.example.com/papi/v1/player/logout \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=player_user_001"

响应字段

字段	类型	说明
code	int	状态码，0 为成功
data	object	返回数据（空对象）
msg	string	提示消息

成功响应 (HTTP 200)

{
  "code": 0,
  "data": {},
  "msg": "logout success"
}

失败响应

玩家不存在 (HTTP 200)

{
  "code": 7,
  "data": {},
  "msg": "player not found"
}

Token 校验失败 (HTTP 200)

{
  "code": 1002,
  "data": {},
  "msg": "err.signature.invalid"
}