遍历授权码下的设备

1. 请求地址：GET /sns/{sn}/machines

2. 接口概述：

   查询指定授权码绑定的设备。

3. 请求参数：

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

   如何遍历？

   地址参数

   参数名	参数类型	参数说明	必需	备注
   sn	string	授权码	是

4. 请求体：

   无

5. 请求示例：

   GET /bitanswer/api/sns/{sn}/machines HTTP/1.1
   Host: back-office-api.bitanswer.cn
   bitkey: ••••••

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 2,
          "items": [
              {
                  "id": 548460,
                  "status": 0,
                  "regDate": "2024-08-08 13:49:03",
                  "lastUpdateDate": "2024-08-08 13:49:03",
                  "mid": "[macEx] 00000000"
              },
              {
                  "id": 548469,
                  "status": 0,
                  "regDate": "2024-08-12 14:58:49",
                  "lastUpdateDate": "2024-08-12 15:11:15",
                  "mid": "[hd] 00000001  [cpu] 00000001 [cpuEx2] 00000001  [macEx] 00000001"
              }
          ]
      }
   }

   响应体说明

删除授权码绑定的设备

1. 请求地址：DELETE /sns/{sn}/machines

2. 接口概述：

   根据设备id删除指定授权码下的设备。

3. 请求参数：

   地址参数

   参数名	参数类型	参数说明	必需	备注
   sn	string	授权码	是

4. 请求体：

   参数名	参数类型	参数说明	必需	备注
   id	long	设备id	是

   请求体以数组形式输入。

5. 请求示例：

   DELETE /bitanswer/api/sns/{sn}/machines HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {"id": 548460},
      {"id": 548469}
   ]

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 2,
          "items": [
              {
                  "id": 548460
              },
              {
                  "id": 548469
              }
          ]
      }
   }

回收授权码下所有设备

1. 请求地址：POST /sns/{sn}/machines/return-all

2. 接口概述：

   回收授权码下的所有状态为正常的设备。

3. 请求参数：

   地址参数

   参数名	参数类型	参数说明	必需	备注
   sn	string	授权码	是

4. 请求体：

   无。

5. 请求示例：

   POST /bitanswer/api/sns/{sn}/machines/return-all HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 2,
          "items": [
              {
                  "id": 548460,
                  "status": 1,
                  "regDate": "2024-08-08 13:49:03",
                  "lastUpdateDate": "2024-08-08 13:49:03",
                  "mid": "[macEx] 00000000"
              },
              {
                  "id": 548469,
                  "status": 1,
                  "regDate": "2024-08-12 14:58:49",
                  "lastUpdateDate": "2024-08-12 15:11:15",
                  "mid": "[hd] 00000001  [cpu] 00000001 [cpuEx2] 00000001  [macEx] 00000001"
              }
          ]
      }
   }

   响应体说明

更新授权码指定设备信息

1. 请求地址：PATCH /sns/{sn}/machines

2. 接口概述：

   通过设备ID更新指定设备信息，当前只支持修改状态为正常/回收/禁用的设备状态。

3. 请求参数：

   地址参数

   参数名	参数类型	参数说明	必需	备注
   sn	string	授权码	是

4. 请求体：

   参数名	参数类型	参数说明	必需	备注
   id	long	设备id	是
   status	integer	设备状态	是	只支持更新为以下状态：0：正常，1：回收，33：禁用

5. 请求示例：

   PATCH /bitanswer/api/sns/{sn}/machines HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   {
     "id": 548460, 
     "status":1
   }

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "id": 548460,
                  "status": 1,
                  "regDate": "2024-08-08 13:49:03",
                  "lastUpdateDate": "2024-08-08 13:49:03",
                  "mid": "[macEx] 00000000"
              }
          ]
      }
   }

   响应体说明