查询会员 Session
查询指定会员的所有活躍会话。
API 信息
- 端点:
POST /v2/members/sessions/check - 认证:Bearer Token
- 加密:请求使用 AES-256-GCM 加密,响应为明文 JSON
请求
请求标头
POST /v2/members/sessions/check 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.",
"data": [
{
"mode": "real",
"gamecode": "VP_230001_1",
"sessionInfo": {
"deviceType": 1,
"ipaddress": "127.0.0.1",
"lang": "en",
"gameCode": "VP_230001_1",
"username": "VPSysDevTest001",
"launchType": 2,
"currency": "THB",
"brandCurrency": "THB",
"agentType": 1
}
}
],
"logUUID": "955585ed-adeb-436e-8be0-ebf2b81b7d15"
}
响应欄位说明
| 欄位 | 类型 | 说明 |
|---|---|---|
data | array | 会话列表 |
data[].mode | string | 游戏模式(real: 真钱模式,demo: 试玩模式) |
data[].gamecode | string | 游戏代码 |
data[].sessionInfo | object | 会话详细信息 |
data[].sessionInfo.deviceType | number | 设备类型(1: PC, 2: Mobile) |
data[].sessionInfo.ipaddress | string | IP 地址 |
data[].sessionInfo.lang | string | 语言代码 |
data[].sessionInfo.gameCode | string | 游戏代码 |
data[].sessionInfo.username | string | 会员账号 |
data[].sessionInfo.launchType | number | 启动类型:0 = both,1 = demo,2 = real |
data[].sessionInfo.currency | string | 会员币别 |
data[].sessionInfo.brandCurrency | string | 品牌币别 |
data[].sessionInfo.agentType | number | 代理商类型 |
错误响应
{
"code": 8,
"message": "The User is not exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
常見错误码
| 状态码 | 说明 |
|---|---|
| 8 | 会员不存在 |
| 11 | 参数错误 |
| 81 | 分支配置未找到 |
| 83 | 认证失敗 |
| 84 | 解密失敗 |
更多错误码说明请参考:附录 - 错误码总览