跳到主要内容

查询在线会员

查询当前在线的会员列表。

API 信息​

  • 端点：POST /v2/members/online
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

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

请求参数​

加密前的参数​

{}

加密后的请求体​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}

响应​

成功响应​

{
  "code": 0,
  "message": "No error.",
  "data": {
    "userList": ["testacoount001", "testacoount002"],
    "counts": 2
  },
  "logUUID": "b77d7a71-94f7-4503-8e33-3309a7fc1e19"
}

响应欄位说明​

欄位类型说明
data.userListarray在线会员名稱列表
data.countsnumber总在线会员数

错误响应​

{
  "code": 7,
  "message": "Internal server error",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

常見错误码​

状态码说明
7意外错误

注意事项​

  1. 数据更新頻率：在线会员数据每 30 秒更新一次

相关 API​