強制登出
強制終止指定會員的所有會話或特定會話。
API 信息
- 端點:
POST /v2/members/sessions/logout - 認證:Bearer Token
- 加密:請求使用 AES-256-GCM 加密,響應為明文 JSON
請求
請求標頭
POST /v2/members/sessions/logout HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67
請求參數
加密前的參數(登出所有會話)
{
"username": "player001",
}
加密後的請求體
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
username | string | 是 | 會員帳號 |
響應
成功響應
{
"code": 0,
"message": "No error.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
錯誤響應
{
"code": 8,
"message": "The User is not exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
常見錯誤碼
| 狀態碼 | 說明 |
|---|---|
| 8 | 會員不存在 |
| 11 | 參數錯誤 |
| 81 | 分支配置未找到 |
| 83 | 認證失敗 |
| 84 | 解密失敗 |
更多錯誤碼說明請參考:附錄 - 錯誤碼總覽