公共提交参数,每个命令都需要提交以下公共参数
请求地址:管理后台-软件列表中获取对应软件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=callPHP&fun=函数名¶=参数JSON格式并UTF8编码&user=用户名
调用:"编辑软件->自定义函数(PHP语法)"中的动态函数并返回函数返回值
完整提交明文:
{
"action": "callPHP",
"fun": "addition",
"para": "%7B%220%22%3A%222%22%2C%221%22%3A%223%22%7D",
"user": "quecongsoft",
"sid": "d6fadd40-7267-4178-9b35-4c8ff61e0c07",
"key": "9d8af871e74f5629639544a314adab96",
"uuid": "f9b435f2-28cd-4757-ace8-5dd53a06eded",
"t": "1581857017",
"m1": "4972033a92c2c4c16687d5e830db5fcb",
"m2": "d41d8cd98f00b204e9800998ecf8427e",
"m3": "a0368bba05140b66e8172247da2650ab",
"mcode": "F1E5FD6B-FC18-49EE-A3E5-5C51C5DE1224",
"webkey": "2a829dd8bce3c480b714c737259760f9",
"clientid": "cbb5720b-13bd-4118-a8f7-d81699ff72ce"
}
para原文:{"0":"2","1":"3"},UTF-8编码后为:%7B%220%22%3A%222%22%2C%221%22%3A%223%22%7D
{"0":"2","1":"3"} 翻译成PHP语法为:
array("2","3"); 或 array(0=>"2",1=>"3");
完整返回明文:
{
"status": "success",
"code": "200",
"uuid": "f9b435f2-28cd-4757-ace8-5dd53a06eded",
"result": {
"result": 5
},
"msg": "",
"token": "2e17321ee118b0ab0fb67f5218a67e74",
"t": 1581857010,
"result_token": "1102ac3d53dd0c1cd10a4087f5121b39"
}
数据主体解析:
result.result : 自定义函数的返回值