目录

常规验证-添加黑名单


请求地址

管理后台创建软件后获取例:http://demo.huweidun.cn/ac.php?s=8508c320cacb0634c0e241df2f3345fe

公共提交参数

参数名 示例值 参数说明
sid
00362ace-e994-411a-a9bf-f31f9177b6f3
软件SID,后台添加软件后获得。
uuid d6fadd40-7267-4178-9b35-4c8ff61e0c07 封包安全码,每次必须变动,用于校验数据合法性方案之一。
t 1630766594 客户端10位时间戳。
m1 590b782aa78cc3333c84eaa975ab9dc1 封包token(sid+key+t 拼接后取MD5值)
m2 b1dfd79c7cf0f5df8f77c12352af952c 当前程序MD5值,如果开启校验MD5,则此值必填,可于程序运行时动态读取自身MD5值。
m3 f50ebce838ae4b8e212578dd0bc23d9f moduleMd5,购买授权后获得,如使用dll文件,请传入DLLMD5值,同时在”后台-系统-系统设置”中填写。
mcode b4f43bb8-32dc-4d9a-9094-74e39cd61c37 客户端机器码(自行获取机器码,若机器码变动则会提示转绑[如果开启”绑定机器码”])
clientid 36ebe72d-51d8-4252-b99c-37da152717ac 客户端运行ID,此ID在软件退出之前不可变动,也就是每次启动都生成一个新的clientid,软件退出即作废。
webkey 0241946994e62e289e4622b07154b961 通用秘钥(webKey),购买授权后获得。

公共返回参数

参数名 示例值 参数说明
status
success
success为正常,error为错误。
code 200 200为正常,其它为错误。
msg 账号或密码错误. 错误内容,无错误返回空。
token 324daaf6558361aa8f27d607c72262af 返回封包token(提交封包中的m1+返回封包中t,拼接后取MD5值)
t 1630766888 封包时间戳
uuid d6fadd40-7267-4178-9b35-4c8ff61e0c07 提交封包的UUID,原样返回。
result 请查看不同函数说明 数据主体,Json格式,每个函数返回的数据不同,具体请参照对应函数说明。
result_token 627b0d546ccb1d4896373305d74c6933 数据主体token,将数据以ASCII首字母递增排序,拼接键名与键值,拼接完毕后加上通信秘钥一起取MD5值。

传参说明

  • 只需按规则拼接参数后加密传送即可。

  • 封包内参数分为公共参数和函数参数。

  • 公共参数为所有命令均需要提交的参数。

  • 函数参数根据不同函数说明决定提交哪个参数,对应函数内均有说明。


函数参数

action=addBlacklist&code=黑名单号码&remark=添加备注

  • 黑名单号码可以是IP地址或机器码,如为IP地址,则全站禁止访问(含客户端软件),如为机器码,则仅客户端禁止访问,网站不限制,因为网站无法获取机器码进行对比屏蔽。

提交示例

{
    "action": "addBlacklist",
    "clientid": "c8dd3ff6-b1c9-497b-77d6-5a95d033c2b5",
    "code": "192.168.0.1",
    "key": "GorgBdTnRDYxQGxKC9pYB42O933Pzxx4",
    "m1": "bfc65f58db118d912a8c806f254517d0",
    "m2": "d41d8cd98f00b204e9800998ecf8427e",
    "m3": "a0368bba05140b66e8172247da2650ab",
    "mcode": "de11dbe0-aff6-d5ff-0e38-76e51d30ee21",
    "remark": "测试添加黑名单",
    "sid": "c1162b61-fa71-4214-b66b-014ae6b0a99a",
    "t": "1630823878",
    "uuid": "f5342ad0-fbe1-46c9-75e2-fcbb34ac7374",
    "webkey": "943e508419c4cd486ab894d3f7dbee50"
}

返回示例

{
    "status": "success",
    "code": "200",
    "uuid": "f5342ad0-fbe1-46c9-75e2-fcbb34ac7374",
    "result": [],
    "msg": "",
    "token": "1fcf15718fc3fdaadeade92010697860",
    "t": 1630823877,
    "result_token": "94ab90abb9e671e373d3066b6ad5219f"
}

错误码

错误码 错误消息
258 号码已存在黑名单中.
259 黑名单加入失败,未知原因.