遍历一个授权码的所有关联用户

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

接口说明

• 遍历一个授权码的所有关联用户。

请求参数

• Query

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

• Path

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

请求示例

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

响应示例

{
    "status": 0,
    "data": {
        "items": [
            {
                "nickname": "昵称🎈",
                "name": "test-account-001",
                "guid": "e1ce53a1bdf6434e89446268",
                "regDate": "2022-08-25",
                "status": 0
            },
            {
                "nickname": "nickname-p",
                "name": "fed_account_1",
                "guid": "e46c3b76190d4f53a32d7a12",
                "regDate": "2022-08-29",
                "status": 0
            }
        ]
    }
}

响应体参数说明

批量关联用户

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

接口说明

• 给授权码关联多个用户。
• 返回关联成功的用户名称列表。

请求参数

• Path

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

• Body

  参数名	类型	必需	中文名
  name	string	是	帐号

注：请求体需以数组形式输入

请求示例

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

[
    {
        "name": "u_f12347446"
    }
]

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "sn": "ABCDEFG123456",
                "name": "u_f12347446"
            }
        ]
    }
}

批量解除一个授权码关联的用户

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

接口说明

• 批量解除授权码关联的用户，仅删除关联关系，不会删除用户。
• 返回解除的用户列表。

请求参数

• Path

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

• Body

  参数名	类型	必需	中文名
  name	string	是	帐号

注：请求体需以数组形式输入

请求示例

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

[
    {
        "name": "u_f12347446"
    }
]

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "sn": "ABCDEFG123456",
                "name": "u_f12347446"
            }
        ]
    }
}

检索一个授权码的关联用户

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

接口说明

• 按条件查询授权码关联的用户。
• 返回符合条件的用户列表。

请求参数

• Path

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

• Body

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

支持的查询参数如下表所示

参数名	类型	检索类型	必需	中文名
name	string	query|sort	否	帐号

请求示例

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

{
    "querys": [
        {
            "name": "name",
            "op": "like",
            "values": [
                "%account%"
            ]
        }
    ]
}

检索请求参数用法

响应示例

{
    "status": 0,
    "data": {
        "total": 2,
        "items": [
            {
                "nickname": "昵称🎈",
                "guid": "e1ce53a1bdf6434e89446268",
                "regDate": "2022-08-25",
                "status": 0,
                "name": "test-account-001"
            },
            {
                "nickname": "nickname-p",
                "guid": "e46c3b76190d4f53a32d7a12",
                "regDate": "2022-08-29",
                "status": 0,
                "name": "fed_account_1"
            }
        ]
    }
}

响应体参数说明

为授权码关联一个用户

请求地址： POST /sns/{sn}/users/user/{name}

接口说明

• 给授权码关联用户帐号。
• 返回关联后的用户。

请求参数

• Path

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

请求示例

POST https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/users/user/u_f12347446
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "sn": "ABCDEFG123456",
                "name": "u_f12347446"
            }
        ]
    }
}

解除一个授权码关联的一个用户

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

接口说明

• 解除授权关联用户，仅删除关联关系，不删除用户。
• 返回解除的用户名称。

请求参数

• Path

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

请求示例

DELETE https://back-office-api.bitanswer.cn/bitanswer/api/sns/ABCDEFG123456/users/u_f12347446
bitkey: xxx

响应示例

{
    "status": 0,
    "data": {
        "total": 1,
        "items": [
            {
                "sn": "ABCDEFG123456",
                "name": "u_f12347446"
            }
        ]
    }
}