Query Online Players
Query the list of currently online players.
API Information
- URL:
POST /v2/members/online - Authentication: Bearer Token
- Encryption: Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
request
Request Headers
POST /v2/members/online 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
Request Parameters
Parameters Before Encryption
{}
Encrypted Request Body
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"userList": ["testacoount001", "testacoount002"],
"counts": 2
},
"logUUID": "b77d7a71-94f7-4503-8e33-3309a7fc1e19"
}
Response Field Description
| Field | Type | Description |
|---|---|---|
data.userList | array | List of online player names |
data.counts | number | Total number of online players |
Error Response
{
"code": 7,
"message": "Internal server error",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Common Error Codes
| Code | Description |
|---|---|
| 7 | Unexpected error |
Important Notes
- Data Update Frequency: Online player data is updated every 30 seconds