接口简介
- 管理单个用户的黑名单
接口列表
查询某个用户的黑名单列表
接口请求说明
请求地址
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 作者:黄琛