SAM联BAN库API V1

开放查询地址

http://ban.samgame.cn/query/steam/你要查询的steamid

http://ban.samgame.cn/query/qq/你要查询的QQ

http://ban.samgame.cn/query/wx/你要查询的微信 ### 开发者接口

接口网址: http://ban.samgame.cn

接口方式：POST

Header

字段 类型 参数示例 描述
App String App *必传参数
Token String kuaixue890cda432930f…… 登录接口获取的Token【sign二选一传入即可】
sign String 890cda432930f55ff131…… 账户唯一key计算得到的校验码，详情见Sign计算
Time String 1721981666 十位数的时间戳【使用sign校验时一同传入】

接口：

PS:接口描述中携带 * 项为必传参数，未携带 * 项，除【】中标注，为可忽略字段。 —

登录接口：/user/login

提交方式：POST
字段 类型 参数示例 描述
account String kuaixue *账户
pass String 1234568 *密码

返回：

{
    "code": 200,
    "msg": "登录成功！",
    "time": "1721873552",
    "token": "kuaixuedc9874eb3e04779c03....."
}

账号心跳：/user/ping

提交方式：POST

无惨，登录成功后，在Header携带Token,300内秒访问一次，【建议280秒】，禁止在100秒内重复心跳，频繁高频心跳将永久封禁账号或屏蔽IP。 返回：

{
    "code": 200,
    "msg": "pong"
}

上传接口：/api/UploadBan

提交方式：POST
字段 类型 示例 描述
SteamID String 7656156487…. 被举报者关联的SteamID【QQ WX 三选一】
QQ String 1234567 被举报者关联的QQ【SteamID WX 三选一】
WX String gua_bi 被举报者关联的WX【SteamID QQ 三选一】
Reasons String 勒比海盗又把代码删掉了QAQ *举报内容的详细内容。200字以内。
Evidence String http:s//pan.baidu.com/……. *证据链接地址，推荐存放在网盘内。
UpUser String 快雪时晴 *上传者名称，可填写自家服务器服号。
Game String SCUM *来源游戏
ContInfo String E-mail *联系方式,方便审核员用对应平台联系你。平台不限但是请标注清楚
Contnum String baimu.@samgame.cn *联系你的具体账户。描述清楚，方便后续审核联系你。

返回：

{
    "code": 200,
    "msg": "上传联BAN成功，请等待审核，提供完整的证据视频或聊天截图，能提升审核成功的几率。"
}

查询接口：/api/Query

提交方式：POST
字段 类型 示例 描述
SteamID String 7656156487…. steamid【三选一传入】
QQ String 66666666 QQ账号【三选一传入】
WX String gua_bi 绿泡泡账号【三选一传入】

返回:

{
    "code": 200,
    "msg": [
        {
            "ID": "15794",
            "SteamID": "76561199206486984",
            "QQ": " ",
            "WX": " ",
            "Reasons": "勒比海盗删库跑路。",
            "Evidence": "samgame.cn",
            "UpUser": "SAM社区",
            "Auditor": "白木",
            "UploadTime": "2024-07-24 23:41:39",
            "TimeLock": "2024-07-24 23:41:42",
            "OffBan": "未知",
            "CommunityBan": "true",
            "Game": "SCUM"
        }
    ]
}

查询接口回参描述：

字段 描述
SteamID 关联的SteamID
QQ 关联的QQ
WX 关联的微信
Reasons 联办理由
Evidence 证据链接
UpUser 上传者
Auditor 审核人
UploadTime 上传时间
TimeLock 联办时间
OffBan 开发封禁状态【保留项】
CommunityBan 社区封禁状态
Game 涉及到的游戏

Sign计算方式

sign样式示例：%kuaixue%$0e268872d41f8440ff085cf461290566
%+联ban账户+%$+ 取MD5值（十位时间戳文本+账户唯一秘文本）
主要是将时间戳与账户唯一key做拼接之后取MD5
以下为代码示例：

易语言：

.版本 2
.支持库 dp1
.支持库 eAPI

.子程序 计算Sign, 文本型
.参数 参_时间戳, 文本型, 参考, 返回时间戳上传服务器
.局部变量 初始化时间, 日期时间型
.局部变量 局_时间戳, 整数型
.局部变量 秘钥, 文本型
.局部变量 Sign, 文本型
.局部变量 md5, 文本型

初始化时间 ＝ 到时间 (“1970-01-01 08:00:00”)
局_时间戳 ＝ 取时间间隔 (取现行时间 (), 初始化时间, #秒)
参_时间戳 ＝ 局_时间戳
秘钥 ＝ “账户信息中的账户唯一秘钥”
md5 ＝ 取数据摘要 (到字节集 (格式化文本 (“%s%s”, 局_时间戳, 秘钥)))
Sign ＝ 格式化文本 (“%%%s%%$%s”, “联办账户”, md5)
返回 (Sign)

go:

func GetSign() (reSign string,time string) {
	timestamp := strconv.FormatInt(time.Now().Unix(), 10)
	hash := md5.Sum([]byte(timestamp + "账户信息中的账户唯一秘钥"))
	encryption := hex.EncodeToString(hash[:])
	reSign := fmt.Sprintf("%%%v%%$%v", "你账户的用户名", encryption)
	return reSign,timestamp
}