云黑系统API调用 – 北梦の博客

添加黑名单

调用方法：GET

调用地址：trbl.b52m.cn/add

参数

token	用户唯一标识符
type	数据类型，可选（qq，ip，uuid）
data	添加的数据，与类型绑定
reason	原因

code返回

正确返回

错误返回

200

添加成功

500	数据库连接失败
400	加入失败，数据库写入失败
401	无效请求方法，请求方法不是get
402	缺少必要参数
403	未找到token，token不存在
404	该数据已经添加过了

删除黑名单

调用方法：GET

调用地址：trbl.b52m.cn/del

参数

token	用户唯一标识符
type	数据类型，可选（qq，ip，uuid）
data	添加的数据，与类型绑定

code返回

正确返回

错误返回

200

删除成功

500	数据库连接失败
400	删除失败，数据库写入失败
401	无效请求方法，请求方法不是get
402	缺少必要参数
403	未找到token，token不存在
404	该数据不在名单中
405	该数据不是由当前用户添加的

更新云黑信息

调用方法：GET

调用地址：trbl.b52m.cn/up

参数

token	用户唯一标识符
type	数据类型，可选（qq，ip，uuid）
data	更新的数据值，与类型绑定
reason	更新的新的原因

code返回

正确返回

错误返回

200

修改成功

500	数据库连接失败
400	更新失败，数据库写入失败
401	无效请求方法，请求方法不是get
402	缺少必要参数
403	未找到token，token不存在
404	该数据不在名单中
405	该数据不是由当前用户添加的

查询指定黑名单信息

调用方法：GET

调用地址：trbl.b52m.cn/search

参数

token	用户唯一标识符
type	查询的数据类型，可选（qq，ip，uuid）
data	查询的数据值，与类型绑定

code返回

正确返回

错误返回

200	查询成功，返回详细信息

例：

{
	"code": 200,
	"data": "123", // 添加的数据
	"type": "qq", // 数据类型
	"user_id": 1, // 添加该数据的用户id
	"reason": "测试1", // 添加该数据的原因
	"addtime": "2024-03-18 01:38:45", // 添加该数据的时间
	"uptime": "2024-03-18 01:38:45" // 修改该数据的时间
}

500	数据库连接失败
401	无效请求方法，请求方法不是get
402	缺少必要参数
403	未找到token，token不存在
404	该数据不在名单中

列出指定类型的所有数据

调用方法：GET

调用地址：trbl.b52m.cn/show

参数

token	用户唯一标识符
type	添加的数据类型，可选（qq，ip，uuid）

code返回

正确返回

错误返回

200

添加成功

例：

{
	"code": 200,
	"blacklist": [
		{
			"data": "12135", // 添加的数据
			"type": "qq", // 数据类型
			"user_id": 1, // 添加该数据的用户id
			"reason": "999", // 添加该数据的原因
			"addtime": "2024-03-18 01:12:38", // 添加该数据的时间
			"uptime": "2024-03-18 01:12:38" // 修改该数据的时间
		},
		{
			"data": "1213",
			"type": "qq",
			"user_id": 1,
			"reason": "999",
			"addtime": "2024-03-18 01:25:34",
			"uptime": "2024-03-18 01:25:34"
		},
		{
			"user_id": 1,
			"data": "123",
			"type": "qq",
			"reason": "测试2",
			"addtime": "2024-03-18 01:38:45",
			"uptime": "2024-03-18 01:40:42"
		}
	]
}