遍历用户在线设备

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

  2. 接口概述:

    遍历指定授权码的指定用户在线的设备列表。

  3. 请求参数:

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

    如何遍历?

    地址参数

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

  5. 请求示例:

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

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "version": 12107,
                   "execNumber": 3,
                   "ip": "172.17.0.1",
                   "mid": " 2-00000000 6-00000000",
                   "loginDate": "2024-08-28 17:15:18",
                   "lastConnectDate": "2024-08-28 17:15:18",
                   "userId": 1
               }
           ]
       }
    }

    响应体说明

批量删除用户在线设备

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

  2. 接口概述:

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

  3. 请求参数:

    地址参数

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

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

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

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "version": 12107,
                   "execNumber": 3,
                   "ip": "172.17.0.1",
                   "mid": " 2-00000000 6-00000000",
                   "loginDate": "2024-08-28 17:15:18",
                   "lastConnectDate": "2024-08-28 17:15:18",
                   "userId": 1
               }
           ]
       }
    }

    响应体说明

查询用户指定的在线设备

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

  2. 接口概述:

    查询指定授权码的指定用户的指定在线设备信息。

  3. 请求参数:

    地址参数

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

  5. 请求示例:

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

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "version": 12107,
                   "execNumber": 3,
                   "ip": "172.17.0.1",
                   "mid": " 2-00000000 6-00000000",
                   "loginDate": "2024-08-28 17:15:18",
                   "lastConnectDate": "2024-08-28 17:15:18",
                   "userId": 1
               }
           ]
       }
    }

    响应体说明

删除用户指定的在线设备

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

  2. 接口概述:

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

  3. 请求参数:

    地址参数

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

  5. 请求示例:

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

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "id": 1,
                   "version": 12107,
                   "execNumber": 3,
                   "ip": "172.17.0.1",
                   "mid": " 2-00000000 6-00000000",
                   "loginDate": "2024-08-28 17:15:18",
                   "lastConnectDate": "2024-08-28 17:15:18",
                   "userId": 1
               }
           ]
       }
    }

    响应体说明