接口简介

  • 管理单个用户的黑名单

接口列表

查询某个用户的黑名单列表

接口请求说明

请求地址

https://站点接口域名/openapi/users/{ID}/black

请求方式

GET

请求参数

参数名 类型 是否必须 说明
id int 目标用户的ID

接口响应说明

响应示例

{
    "code": 0,
    "text": "",
    "data": {
        "list": [
            {
                "user_id": "2",
                "time": "1409023098"
            },
            {
                "user_id": "6",
                "time": "1624427981"
            }
        ]
    },
    "time": 1624427985
}

data.list单项参数说明

参数名 类型 说明
user_id int 黑名单中的用户ID
time int 加入黑名单的时间戳

添加黑名单

接口请求说明

请求地址

https://站点接口域名/openapi/users/{ID}/black

请求方式

POST

请求参数

参数名 类型 是否必须 说明
id int 目标用户
链接中
user_id int 被加入黑名单的用户ID

接口响应说明

根据code判断是否操作成功

响应示例

{
    "code": 1,
    "text": "用户已经在黑名单中",
    "time": 1623917793
}

{
    "code": 0,
    "text": "",
    "data": true,
    "time": 1623917892
}

移出黑名单

接口请求说明

请求地址

https://站点接口域名/openapi/users/{ID}/black

请求方式

DELETE

请求参数

参数名 类型 是否必须 说明
id int 目标用户
链接中
user_id int 被移出黑名单的用户ID

接口响应说明

根据code判断是否操作成功

响应示例

{
    "code": 1,
    "text": "用户不在黑名单中",
    "time": 1623917793
}

{
    "code": 0,
    "text": "",
    "data": true,
    "time": 1623917892
}
文档更新时间: 2021-11-26 10:02   作者:黄琛