遍历用户所有在线设备

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

接口说明

  • 遍历用户所有在线设备。
  • 仅当用户在线时返回设备列表。

请求参数

  • Path
    参数名 类型 必需 示例值 说明
    sn string ABCDEFG123456 授权码
    name string account 用户帐号

请求示例

GET https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/users/test-account-001/machines
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "version": 9202,
                "execNumber": 2,
                "ip": "127.0.0.1",
                "id": 4,
                "lastConnectDate": "2022-09-26"
            }
        ]
    }
}

响应体参数说明

批量删除用户在线设备

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

接口说明

  • 批量删除用户在线的设备,会导致用户登出。
  • 返回删除成功设备列表。

请求参数

  • Path

    参数名 类型 必需 示例值 说明
    sn string ABCDEFG123456 授权码
    name string account 用户帐号
  • Body

    参数名 类型 必需 中文名
    array 设备id数组

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/users/test-account-001/machines
bitkey: xxx
Content-Type: application/json

[1, 2, 3]

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "version": 9202,
                "execNumber": 2,
                "ip": "127.0.0.1",
                "mid": " 2-01000000 6-01000000",
                "sessions": []
            }
        ]
    }
}

获取用户一个在线设备

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

接口说明

  • 使用ID获取用户一个在线设备。

请求参数

  • Path
    参数名 类型 必需 示例值 说明
    sn string ABCDEFG123456 授权码
    name string account 用户帐号
    id integer 1 在线设备ID

请求示例

GET https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/users/test-account-001/machines/
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "version": 9202,
                "execNumber": 2,
                "ip": "127.0.0.1",
                "id": 5,
                "lastConnectDate": "2022-09-26"
            }
        ]
    }
}

响应体参数说明

删除指定ID的用户在线设备

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

接口说明

  • 删除指定ID的用户在线设备,会导致用户登出。

请求参数

  • Path
    参数名 类型 必需 示例值 说明
    sn string ABCDEFG123456 授权码
    name string account 用户帐号
    id integer 1 设备ID

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/users/test-account-001/machines/5
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "version": 9202,
                "execNumber": 2,
                "ip": "127.0.0.1",
                "mid": " 2-01000000 6-01000000",
                "sessions": []
            }
        ]
    }
}