查询授权码的比特ID

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

接口说明

• 遍历授权码关联的所有比特ID。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码

• Query

  参数名	类型	必需	示例值	说明
  offset	integer	否	0	起始下标
  limit	integer	否	50	范围（≤1000，默认50）

请求示例

GET https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/bitids? offset=0&limit=10
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 3,
        "items": [
            {
                "status": 0,
                "guid": "AAA",
                "regDate": "2022-01-30"
            },
            {
                "status": 0,
                "guid": "BBB",
                "regDate": "2020-06-08",
                "label": "123"
            },
            {
                "status": 0,
                "guid": "CCC",
                "regDate": "2020-06-08",
                "label": "234"
            }
        ]
    }
}

响应体参数说明

给授权码批量绑定比特ID

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

接口说明

• 给授权码批量绑定比特ID。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码

• Body

  参数名	类型	必需	中文名
  guid	string	否	BIT-ID
  label	string	否	喷码

注：需要以数组形式传参，要求guid必须已注册。

请求示例

POST https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/bitids
bitkey: xxx
Content-Type: application/json

[
    {
        "guid": "guid",
        "label": "label"
    }
]

响应示例

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

响应体参数说明

批量解除授权码的比特ID绑定

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

接口说明

• 批量解除授权码的比特ID绑定。
• 返回解除绑定的比特ID列表。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码

• Body

  参数名	类型	必需	中文名
  guid	string	否	BIT-ID
  label	string	否	喷码

注：需要以数组形式传参，guid和label二选一即可。

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/bitids
bitkey: xxx
Content-Type: application/json

[
    {
        "guid": "1234567812345611",
        "label": "7777"
    }
]

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "guid": "1234567812345611",
                "label": "7777"
            }
        ]
    }
}

条件检索授权码的比特ID

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

接口说明

• 按条件检索授权码关联的比特ID。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码

• Query

  参数名	类型	必需	示例值	说明
  offset	integer	否	0	起始下标
  limit	integer	否	50	范围（小于1000，默认50）

• Body

  参数名	类型	必需	中文名
  querys	array	否	查询条件
  sorts	array	否	排序条件

支持的参数见下表，检索类型query表示可用于查询，sort表示可用于排序，query|sort表示可用于查询和排序。

参数名	类型	检索条件	必需	中文名
guid	string	query|sort	否	BIT-ID
label	string	query|sort	否	喷码
sn	string	query|sort	否	授权码
status	integer	query|sort	否	状态
regDate	string	query|sort	否	注册时间

请求示例

POST https://back-office-api.bitanswer.cn/bitanswer/api/sns/xxx/bitids/data?offset=0&limit=10
bitkey: xxx
Content-Type: application/json

{
    "querys": [
        {
            "name": "guid",
            "op": "LIKE",
            "values": [
                "123%"
            ]
        }
    ],
    "sorts": [
        {
            "name":"guid",
            "order":"DESC"
        }
    ]
}

检索请求参数用法

响应示例

{
    "status": 0,
    "data": {
        "total": 4,
        "items": [
            {
                "status": 0,
                "guid": "1234567812345679",
                "regDate": "2021-10-26"
            },
            {
                "status": 0,
                "guid": "1234567812345678",
                "regDate": "2021-10-26"
            },
            {
                "status": 0,
                "guid": "1234567812345611",
                "regDate": "2021-10-26"
            },
            {
                "status": 1,
                "guid": "1234567812345610",
                "regDate": "2021-10-26",
                "label": "4321"
            }
        ]
    }
}

响应体参数说明

使用GUID为授权码绑定比特ID

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

接口说明

• 使用GUID（BIT-ID）为授权码绑定比特ID。
• 返回绑定成功的GUID列表。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码
  guid	string	是	xxx	BIT-ID

注：要求guid必须已注册。

请求示例

POST https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/bitids/guid/1234567812345611
bitkey: xxx

响应示例

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

解除授权码绑定的指定GUID的比特ID

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

接口说明

• 使用GUID（BIT-ID）解除授权码绑定的比特ID。
• 返回解除的GUID列表。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码
  guid	string	是	xxx	BIT-ID

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/4I7NL656FYAADVML/bitids/guid/1234567812345679
bitkey: xxx

响应示例

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

使用喷码为授权码绑定比特ID

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

接口说明

• 使用喷码为授权码绑定比特ID。
• 返回绑定的喷码列表。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码
  label	string	是	xxx	喷码

请求示例

POST https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/bitids/label/xxx
bitkey: xxx

响应示例

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

解除授权码绑定的指定喷码的比特ID

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

接口说明

• 解除授权码绑定的指定喷码的比特ID。
• 返回解除绑定的喷码列表。

请求参数

• Path

  参数名	类型	必需	示例值	说明
  sn	string	是	ABCDEFG123456	授权码
  label	string	是	xxx	喷码

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/bitids/label/xxx
bitkey: xxx

响应示例

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