BlackBE Wiki

# 查询API

# [GET] /check 查询玩家信息是否存在于黑名单

说明

通过多个参数查询玩家是否存在于黑名单

说明

此API可以通过提交APIToken来查询私有库条目

ep:https://api.blackbe.work/openapi/v3/check?name=blackbetest&qq=11030503&xuid=2535424045177658 (opens new window)

# 可用参数

这是一个"OR"API

这意味着只要提交的参数中有一个匹配，就会返回信息

注意

请至少提交一个参数来进行查询

请谨慎使用XUID查询

由于历史遗留和XUID采集本身存在难度，导致大部分条目没有记录XUID，所以不推荐依赖XUID来判断玩家是否存在于黑名单

参数 类型 解释
name string 玩家ID
qq string 玩家QQ
xuid string 玩家xuid

# 响应

{
  "success": true,
  "status": 2000,
  "message": "查到了DeSu",
  "version": "v3.1",
  "codename": "Moriya Suwako",
  "time": 1644934343,
  "data": {
    "exist": true, //玩家信息是否存在于云黑名单
    "info": [
		{
			"uuid": "323c1261-76b6-44c8-bdba-bfeab250fee4", //条目UUID
			"name": "blackbetest", //违规玩家ID
			"black_id": "1", //条目所属云黑库，1为公开库，私有库则为私有库的UUID
			"xuid": "2535424045177658", //玩家XUID
			"info": "开发者测试账号", //玩家违规信息
			"level": 1, //违规等级
			"qq": 11030503, //玩家QQ
			"photos": [
				"api.blackbe.work/assets/images/blackbe/public/blackbetest/16449339730.png",
				"api.blackbe.work/assets/images/blackbe/public/blackbetest/16449339731.png",
				"api.blackbe.work/assets/images/blackbe/public/blackbetest/16449339732.png"
			] //证据图片
		},
		{
			"uuid": "f6b876a6-1ee1-47cb-87bc-e54dd5b310fd",
			"name": "TestPlayer",
			"black_id": "2b39814e-43f4-4921-af77-83cdb955e783",
			"xuid": "2535424045177658",
			"info": "测试啦测试",
			"level": 1,
			"qq": 1012140043,
			"photos": null
		}
    ]
  }
}

# Status

Status Message 解释
2000 查到了DeSu 查询成功
2001 用户不存在于黑名单中哦 用户不存在于黑名单中
4000 请至少输入一个参数 参数为空
5000 内部错误 服务器出错

# [POST] /check/private 查询玩家信息是否存在于指定私有库

说明

通过多个参数查询玩家信息是否存在于指定的多个私有库

注意

查询非公开私有库条目需要提交仓库所有者的APIToken

ep:https://api.blackbe.work/openapi/v3/check/private?name=blackbetest&qq=11030503&xuid=2535424045177658 (opens new window)

# 可用参数

这是一个"OR"API

这意味着只要提交的参数中有一个匹配，就会返回信息

注意

请至少提交一个参数来进行查询

请谨慎使用XUID查询

由于历史遗留和XUID采集本身存在难度，导致大部分条目没有记录XUID，所以不推荐依赖XUID来判断玩家是否存在于黑名单

参数 类型 解释
name string 玩家ID
qq string 玩家QQ
xuid string 玩家xuid

[Raw] [Json]

{
	"repositories_uuid": [
		"2b39814e-43f4-4921-af77-83cdb955e783",
		"33f6bc25-6464-452f-bb42-66222eb5514d"
	] //需要查询的私有仓库的UUID
}

# 响应

{
	"success": true,
	"status": 2000,
	"message": "查询成功了DeSu",
	"version": "v3.1",
	"codename": "Moriya Suwako",
	"time": 1641214253,
	"data": [
		{
			"repo_success": true, //查询仓库是否成功
			"repo_uuid": "2b39814e-43f4-4921-af77-83cdb955e783", //仓库UUID
            "exist": true, //玩家ID是否存在于云黑名单
			"info": [
				{
					"uuid": "f6b876a6-1ee1-47cb-87bc-e54dd5b310fd", //条目UUID
					"name": "TestPlayer", //玩家ID
					"xuid": "", //玩家XUID
					"info": "测试啦测试", //玩家违规信息
					"server": "Nyan服务器", //作案服务器
					"time": "2021-12-11", //作案时间
					"level": 1, //违规等级
					"qq": 1012140043, //玩家QQ
					"area_code": "+86", //玩家手机号区号
					"phone": 10000000000 //玩家手机号
				}
			]
		},
		{
			"repo_success": false, //查询非公开私有库没有提交APIToken/查询的非公开私有库不属于用户/私有库不存在 都会返回false
			"repo_uuid": "2b39814e-43f4-4921-af77-83cdb955e78",
			"exist": false,
			"info": []
		}
	]
}

# Status

Status Message 解释
2000 查询成功了DeSu 查询成功
2001 没有查询到任何结果 没有提交任何仓库的UUID
4000 请至少输入一个参数 GET参数为空
4001 无法解析Json 无法解析Json
5000 内部错误 服务器出错

← 私有仓库API →