公共提交参数,每个命令都需要提交以下公共参数
请求地址:管理后台-软件列表中获取对应软件API地址
请求类型:post
提交参数:data=URL编码后密文&sign=sign
| 参数名 | 参数说明 |
|---|---|
| sid | 软件SID,后台添加软件后获得 |
| uuid | 通用唯一识别码,每次必须变动,用于校验数据合法性方案之一. |
| t | 客户端10位时间戳 |
| m1 | 临时封包token(sid+key+t 拼接后取MD5值) |
| m2 | 当前程序MD5值,如果开启校验MD5,则此值必填,可于程序运行时动态读取自身MD5值. |
| m3 | moduleMd5,购买授权后获得,如使用dll文件,请传入DLLMD5值,同时在"后台-系统-系统设置"中填写. |
| mcode | 客户端机器码(自行获取机器码,若机器码变动则会提示转绑[如果开启"绑定机器码"]) |
| clientid | 客户端运行ID,此ID在软件退出之前不可变动,也就是每次启动都生成一个新的clientid,软件退出即作废. |
| webkey | 通用秘钥(webKey),购买授权后获得. |
公共返回参数,每个命令都按如下格式返回
| 参数名 | 参数说明 |
|---|---|
| status | success为正常 error为错误 |
| code | 200为正常,其它为错误,请参照错误码表 |
| msg | 错误内容明文,请参照错误码表 |
| token | 返回封包token(提交封包中的m1+返回封包中t,拼接后取MD5值) |
| t | 封包时间 |
| uuid | 提交封包的UUID |
| result | 数据主体,每个函数返回的数据不同,具体请参照对应函数说明. |
| result_token | 数据主体token,将数据以ASCII首字母递增排序,拼接键名与键值,拼接完毕后加上通信秘钥一起取MD5值. |
函数参数:action=logout&user=用户名
退出登录,服务器立即更新用户状态,否则如果不调用此函数,当服务器没有接到心跳包时才会判定用户退出.
完整提交明文:
{
"action": "logout",
"user": "admin",
"sid": "d6fadd40-7267-4178-9b35-4c8ff61e0c07",
"key": "9d8af871e74f5629639544a314adab96",
"uuid": "4a8f608c-e460-4657-810d-822c9f9c3ac5",
"t": "1581855150",
"m1": "3b1833b01e250235e23c34c1d304b52c",
"m2": "d41d8cd98f00b204e9800998ecf8427e",
"m3": "a0368bba05140b66e8172247da2650ab",
"mcode": "F1E5FD6B-FC18-49EE-A3E5-5C51C5DE1224",
"webkey": "2a829dd8bce3c480b714c737259760f9",
"clientid": "6edf81c4-d83e-4ff6-86d3-f6cb7b4bfb1d"
}
完整返回明文:
{
"status": "success",
"code": "200",
"uuid": "4a8f608c-e460-4657-810d-822c9f9c3ac5",
"result": [],
"msg": "",
"token": "dad0a43bae1db2d5bc3ea7e632d97a9c",
"t": 1581855143,
"result_token": "0b983fb0b5478d866a0de13dd424c1a3"
}
此函数没有数据主体,根据返回状态判定是否成功即可
如果出错,请查看错误码(code),或错误信息(msg)
