遍历用户会话

  1. 请求地址:GET /sns/{sn}/users/{name}/sessions

  2. 接口概述:

    遍历指定授权码的指定用户在线的会话列表。

  3. 请求参数:

    参数名 参数类型 参数说明 必需 备注
    offset integer 响应结果起始下标 默认0
    limit integer 响应结果的数量 默认50,最大1000

    如何遍历?

    地址参数

    参数名 参数类型 参数说明 必需 备注
    sn string 授权码
    name string 帐号
  4. 请求体:

  5. 请求示例:

    GET /bitanswer/api/sns/{sn}/users/{name}/sessions HTTP/1.1
    Host: back-office-api.bitanswer.cn
    bitkey: ••••••
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 3,
                   "loginDate": "2024-08-28 17:27:11",
                   "lastConnectionDate": "2024-08-28 17:27:12",
                   "lastSyncDate": "2024-08-28 17:27:12",
                   "userName": "user_name",
                   "clientVersion": 12107,
                   "commandExecutedNumber": 2
               }
           ]
       }
    }

    响应体说明

批量删除用户会话

  1. 请求地址:DELETE /sns/{sn}/users/{name}/sessions

  2. 接口概述:

    批量删除指定授权码的指定用户在线的指定设备。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    sn string 授权码
    name string 帐号
  4. 请求体:

    参数名 参数类型 参数说明 必需 备注
    array 设备id列表 由integer类型组成的数组
  5. 请求示例:

    DELETE /bitanswer/api/sns/{sn}/users/{name}/sessions HTTP/1.1
    Host: back-office-api.bitanswer.cn
    Content-Type: application/json
    bitkey: ••••••
    
    [
       3
    ]
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "loginDate": "2024-08-28 17:27:11",
                   "lastConnectionDate": "2024-08-28 17:27:12",
                   "lastSyncDate": "2024-08-28 17:27:12",
                   "userName": "unittest_accountb6858a60",
                   "clientVersion": 12107,
                   "commandExecutedNumber": 2
               }
           ]
       }
    }

    响应体说明

查询用户指定会话

  1. 请求地址:GET /sns/{sn}/users/{name}/sessions/{id}

  2. 接口概述:

    查询指定授权码的指定用户的指定会话信息。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    sn string 授权码
    name string 帐号
    id integer 会话id
  4. 请求体:

  5. 请求示例:

    GET /bitanswer/api/sns/{sn}/users/{name}/sessions/{id} HTTP/1.1
    Host: back-office-api.bitanswer.cn
    bitkey: ••••••
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 3,
                   "loginDate": "2024-08-28 17:27:11",
                   "lastConnectionDate": "2024-08-28 17:27:12",
                   "lastSyncDate": "2024-08-28 17:27:12",
                   "userName": "user_name",
                   "clientVersion": 12107,
                   "commandExecutedNumber": 2
               }
           ]
       }
    }

    响应体说明

删除用户指定会话

  1. 请求地址:DELETE /sns/{sn}/users/{name}/sessions/{id}

  2. 接口概述:

    删除指定授权码的指定用户的指定会话。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    sn string 授权码
    name string 帐号
    id integer 会话id
  4. 请求体:

  5. 请求示例:

    DELETE /bitanswer/api/sns/{sn}/users/{name}/sessions/{id} HTTP/1.1
    Host: back-office-api.bitanswer.cn
    bitkey: ••••••
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "loginDate": "2024-08-28 17:27:11",
                   "lastConnectionDate": "2024-08-28 17:27:12",
                   "lastSyncDate": "2024-08-28 17:27:12",
                   "userName": "user_name",
                   "clientVersion": 12107,
                   "commandExecutedNumber": 2
               }
           ]
       }
    }

    响应体说明