以下是所有可用的API接口,点击查看详细文档:
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 填写kmlogon |
| 应用 | app | 是 | GET | 填写后台应用APPID |
| 卡密 | kami | 是 | GET/POST | 填写提交的卡密 |
| 设备码 | markcode | 是 | GET/POST | 如果开启了[验证设备]需提交此项 如果提交参数 quit 则是退出卡密心跳 |
| 时间戳 | t | 否 | GET/POST | 如果开启了[时间差效验]需提交此项 |
| 数据签名 | sign | 否 | GET/POST | 如果开启了[数据签名]需提交此项 |
| 名称 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码,200表示成功 |
| message | String | 请求出错时的错误信息 |
| expires | String | 卡密过期时间,格式化的 |
| expires_ts | String | 过期时间戳,秒级,10位的 | time | String | 服务器当前时间戳,秒级,10位的 |
//心跳正常
{
"code": 200,
"msg": {
"message": "心跳请求成功",
"expires": "2024-01-07 19:26:34",
"expires_ts": "1704626794"
},
"time": 1704022708,
"check": "40c61b5c845ce218122a0e4309d6b72e"
}
//心跳时间戳超时
{
"code": 106,
"msg": "心跳超时卡密冻结,请重新登录,重置心跳解冻卡密",
"time": 1704028749,
"check": "dc3b764154ec4e7977c3d451947b05d4"
}
//心跳时间戳超时,需要重新登录卡密
{
"code": 107,
"msg": "心跳失败,请重新登录,重置心跳",
"time": 1704028850,
"check": "a83e3b51d1b1c1633fcca53a9b220b03"
}
//重新登录卡密,卡密解冻,心跳正常
{ "code": 200,
"msg": "心跳重置成功",
"time": 1704029174,
"check": "8562d8fd7d841b4271a9e420f0eb3a2c"
}
//心跳失败状态
{
"code": 201,
"msg": "心跳请求失败,卡密已到期",
"time": 1704023240,
"check": "a58c19f1d60ab53a6e51dd41efff58b1"
}
//如未登录卡密就开始心跳请求
{
code: 112,
msg: '心跳失败,请先登录卡密注册心跳',
time: 1705140355,
check: '00ec3bfa0b472ea190384891f5a0b6c0'
}
//当服务端在指定时间未收到心跳请求
{
code: 110,
msg: '心跳失败,未再有效时间内心跳请求',
time: 1705140355,
check: '00ec3bfa0b472ea190384891f5a0b6c0'
}
//退出卡密心跳请求
{
code: 200,
msg: '已退出卡密心跳',
time: 1705140373,
check: '9811b0b3d01c9708b8f7943ebdd2559c'
}
149,'心跳请求失败,卡密不存在'
150,'心跳请求失败,卡密已登录其它设备'
151,'心跳请求失败,卡密已被禁用'
169,'心跳请求失败,ip验证失败'
您可以在下方填写参数,实时测试API的调用效果。
这些错误码适用于所有API,通常表示系统级别的错误或限制
| 错误码 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
这些错误码专用于当前接口,表示与业务逻辑相关的错误
| 错误码 | 类型 | 说明 |
|---|