数据格式
不同的API接口,一般只是data或者result下的数据不一样,外层都是一样的
请求
key | 类型 | 说明 |
---|---|---|
data | object(json对象) | 要提交的数据,如果有加密,那么要加密,加密后为String(文本型) |
data.device_info | String(文本型) | 设备信息 |
data.device_code | String(文本型) | 机器码 |
data.timestamp | String(文本型) | 10位时间戳 |
skey | String(文本型) | 软件的key |
vkey | String(文本型) | 版本的key |
sign | String(文本型) | sign签名 |
举例:以[初始化]接口为例
如果软件未开启数据加密,那么发送的数据如下
{
"data": {
"device_info": "windows 10",
"device_code": "5A79565CC85400F0-83B59DB87562D3CA4B732957016075CF",
"timestamp": "1641975824"
},
"skey": "7c580b6e-56fc-41ac-953c-8b6896e26eb1",
"vkey": "c0c076e9-9590-da1d-b50b-fcedde7f3308",
"sign": "6bf2a06b04132e15ea6f1eedc71d50c8"
}
如果软件开启了数据加密,那么发送的数据如下
{
"data": "5d8GlF9shGlirTAtE0pTvp9T7BchyXNh4o/nFq/WkWuQiBxBo4Siq+XBtbU+9mwAWo//qGx8bEeghnmtCYSlWgp1zPXgIlYabyKDYP/XtpMwcj1+fXkLTGz6y2FmLVlArYHBWKkSPMnyNWfoxsBwzHJSJcscvBsXYhBTtdjkJHI=",
"skey": "7c580b6e-56fc-41ac-953c-8b6896e26eb1",
"vkey": "c0c076e9-9590-da1d-b50b-fcedde7f3308",
"sign": "50be20e3c534c84e1b3a98ae1a937c87"
}
响应
key | 类型 | 说明 |
---|---|---|
result | object(json对象) | 收到的数据,如果软件开启了加密,此时为String(文本型) ,需要解密为json |
code | int(整数型) | 状态,200为成功,300为被封禁,其他为失败 |
success | Boolean(逻辑型) | 状态:true为成功,false为失败 |
msg | String(文本型) | 文本说明 |
timestamp | int(整数型) | 13位时间戳 |
sign | String(文本型) | sign签名 |
举例:以[检测更新]接口为例
如果软件未开启数据加密,那么收到的数据如下
{
"code": 200,
"success": true,
"msg": "检测到有新版本",
"sign": "23e84bf6c0cb1b699bb7c2d1a87c6f56",
"result": {
"timeStamp": "1642489926",
"ver": "1.0.1",
"haveNew": "1",
"list": [{
"ver": "1.0.2",
"updType": 1,
"updLog": "asda阿萨德",
"updTime": 1642145917,
"status": 1
}, {
"ver": "1.0.1",
"updType": 1,
"updLog": "阿萨德",
"updTime": 1642145917,
"status": 1
}]
},
"timestamp": 1642489926159
}
如果软件开启了数据加密,那么收到的数据如下
{
"code": 200,
"success": true,
"msg": "检测到有新版本",
"sign": "4db4dfc16ce86b928f4ef04001277fc9",
"result": "2bsFES1hr2gdRZ17oYE+zjFd2l5rtK+b1g46vri1jkuY4oudV0e6zNrm+N1D47xvgjN\/8g8K81eIGhlTByXLhDfkNHD1jTcd+ES3Z4z\/FxKU0CWIg\/LqoJWCRsrJ4Fe6uX5cozKIEkpb\/v6\/0tWteGj+Au2QdxipYm47FKJvmMci7bFHEcUoO8JmW0GH636xUiQaRrhNmZk\/l\/nb8cleNNx0vA99KD6\/OmgDhxii3gwujlxj4HtnzizIJ0qI3oFWKKTW7JHoWSQKaanesCvFBM8D9xiChdDEEGDayjldCUeGizNqusnafFNnMGxES4aw",
"timestamp": 1642490543050
}
msg和code的特殊情况
如果code=300,代表ip、机器码、账号被封禁,那么msg的格式如下
msg=被封禁&type=device_code&value=5A79565CC85400F0&toTime=1642587945&time=1642577445&why=呵呵
key | 类型 | 说明 |
---|---|---|
msg | String(文本型) | 固定为:被封禁 |
type | String(文本型) | 取值有:ip、device_code、user |
value | String(文本型) | 分别为ip、机器码、账号 |
toTime | String(文本型) | 封禁解除时间戳,-1=永久封禁 |
time | String(文本型) | 被添加封禁的时间 |
why | String(文本型) | 封禁原因 |
修改于 3 年前