遍历授权码的Bit-ID

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

2. 接口概述：

   遍历指定授权码绑定的Bit-ID数据。

3. 请求参数：

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

   如何遍历？

   地址参数

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

4. 请求体：

   无

5. 请求示例：

   GET /bitanswer/api/sns/{sn}/bitids?limit=1 HTTP/1.1
   Host: back-office-api.bitanswer.cn
   bitkey: ••••••

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "status": 0,
                  "guid": "AAAAAAAAAAAAAAAA",
                  "regDate": "2023-06-28 19:39:29",
                  "tokenType": 6
              }
          ]
      }
   }

   响应体说明

查询授权码的Bit-ID

1. 请求地址： POST /sns/{sn}/bitids/data

2. 接口概述：

   根据指定条件查询指定授权码绑定的Bit-ID。

3. 请求参数：

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

   如何遍历？

   地址参数

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

4. 请求体：

   参数名	参数类型	参数说明	必需	备注
   querys	array	查询参数	否
   sorts	array	排序参数	否

   如何查询？

   querys

   支持：status，guid，regDate，label，sn，tokenType。

   regDate格式为yyyy-MM-dd HH:mm:ss。

   sorts

   支持：status，guid，regDate，label，sn，tokenType。

   参数说明

5. 请求示例：

   POST /bitanswer/api/sns/{sn}/bitids/data HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   {
      "querys": [
          {
              "name": "tokenType",
              "op": "=",
              "values": [
                  6
              ]
          }
      ],
      "sorts": [
          {
              "name": "status"
          }
      ]
   }

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "status": 0,
                  "guid": "AAAAAAAAAAAAAAAA",
                  "regDate": "2023-06-28 19:39:29",
                  "sn": "xxxxxx",
                  "tokenType": 6
              }
          ]
      }
   }

   响应体说明

批量操作Bit-ID

1. 请求地址：POST /sns/{sn}/bitids

2. 接口概述：

   接口存在四种用法：

   不传Bit-ID的guid与喷码label：解绑指定授权码下全部的Bit-ID。

   只传喷码label：根据喷码查询指定的Bit-ID，与指定的授权码进行绑定。

   Bit-ID的guid传空字符串：解绑指定授权码下全部的Bit-ID，将指定的授权码设置为允许绑定Bit-ID。

   比特ID的guid不是NULL值也不是空字符串：根据Bit-ID的guid与Bit-ID类型查询指定的Bit-ID，与指定的授权码进行绑定。

3. 请求参数：

   地址参数

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

4. 请求体：

   参数名	参数类型	参数说明	必需	备注
   tokenType	integer	Bit-ID类型	否	5：传统的Bit-ID 6：Bit-ID浮动
   guid	string	Bit-ID	否	使用guid查询Bit-ID时，tokenType为必需
   label	string	Bit-ID的喷码	否

   参数说明

   请求体以数组形式输入。

5. 请求示例

   不传Bit-ID的guid与喷码label，解绑指定授权码下的全部Bit-ID：

   POST /bitanswer/api/sns/{sn}/bitids  HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {}
   ]

   只传喷码label，根据喷码查询指定的Bit-ID，与指定的授权码进行绑定：

   POST /bitanswer/api/sns/{sn}/bitids  HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {"label" : "UNIT_LABEL_01"}
   ]

   Bit-ID的guid传空字符串，解绑指定授权码下的全部Bit-ID，设置授权码绑定比特ID：

   POST /bitanswer/api/sns/{sn}/bitids  HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {"guid" : ""}
   ]

   比特ID的guid不是NULL值也不是空字符串，根据Bit-ID的guid与Bit-ID类型查询指定的Bit-ID，与指定的授权码进行绑定

   POST /bitanswer/api/sns/{sn}/bitids  HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {
       "guid" : "AAAAAAAAAAAAAAAA",
       "tokenType" : 5
      }
   ]

6. 响应示例

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "guid" : "AAAAAAAAAAAAAAAA",
                  "tokenType" : 5
              }
          ]
      }
   }

   响应体说明

批量解绑Bit-ID

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

2. 接口概述：

   查询具体的Bit-ID与指定授权码进行解绑。

3. 请求参数：

   地址参数

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

4. 请求体：

   参数名	参数类型	参数说明	必需	备注
   guid	string	Bit-ID	否	guid与label必须存在一个
   label	string	Bit-ID的喷码	否	guid与label必须存在一个

   参数说明

   请求体以数组形式输入。

5. 请求示例

   DELETE /bitanswer/api/sns/{sn}/bitids  HTTP/1.1
   Host: back-office-api.bitanswer.cn
   Content-Type: application/json
   bitkey: ••••••
   
   [
      {
       "guid" : "xxxxx"
      }
   ]

6. 响应示例

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "guid" : "AAAAAAAAAAAAAAAA"
              }
          ]
      }
   }

   响应体说明

按Bit-ID为授权码绑定比特ID

1. 请求地址：POST /sns/{sn}/bitids/guid/{guid}

2. 接口概述：

   根据Bit-ID查询指定的比特ID与指定的授权码进行绑定。

3. 请求参数：

   地址参数

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

4. 请求体：

   无

5. 请求示例：

   POST /bitanswer/api/sns/{sn}/bitids/guid/{guid} HTTP/1.1
   Host: back-office-api.bitanswer.cn
   bitkey: ••••••

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "guid": "AAAAAAAAAAAAAAAA"
              }
          ]
      }
   }

   响应体说明

按Bit-ID为授权码解绑比特ID

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

2. 接口概述：

   根据Bit-ID查询指定的比特ID与指定的授权码进行解绑。

3. 请求参数：

   地址参数

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

4. 请求体：

   无

5. 请求示例：

   DELETE /bitanswer/api/sns/{sn}/bitids/guid/{guid} HTTP/1.1
   Host: back-office-api.bitanswer.cn
   bitkey: ••••••

6. 响应示例：

   {
      "status": 0,
      "data": {
          "total": 1,
          "items": [
              {
                  "guid": "AAAAAAAAAAAAAAAA"
              }
          ]
      }
   }

   响应体说明

按喷码为授权码绑定比特ID

1. 请求地址：POST /sns/{sn}/bitids/label/{label}

2. 接口概述：

   根据喷码查询指定的比特ID与指定的授权码进行绑定。

3. 请求参数：

   地址参数

   参数名	参数类型	参数说明	必需	备注
   sn	string	授权码	是
   label	string	Bit-ID的喷码	是

4. 请求体：

   无

5. 请求示例：

     POST /bitanswer/api/sns/{sn}/bitids/label/{label} HTTP/1.1
     Host: back-office-api.bitanswer.cn
     bitkey: ••••••

6. 响应示例：

     {
         "status": 0,
         "data": {
             "total": 1,
             "items": [
                 {
                     "label": "LABEL_1"
                 }
             ]
         }
     }

   响应体说明

按喷码为授权码解绑比特ID

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

2. 接口概述：

   根据喷码查询指定的比特ID与指定的授权码进行解绑。

3. 请求参数：

   地址参数

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

4. 请求体：

   无

5. 请求示例：

     DELETE /bitanswer/api/sns/{sn}/bitids/label/{label} HTTP/1.1
     Host: back-office-api.bitanswer.cn
     bitkey: ••••••

6. 响应示例：

     {
         "status": 0,
         "data": {
             "total": 1,
             "items": [
                 {
                     "label": "LABEL_1"
                 }
             ]
         }
     }

   响应体说明