稳定、快速、高效的 数据接口服务
当前接口状态 · 正常
心跳
接口地址: https://ccc.gykjs.cn/api.php?api=heartbeat
返回格式: JSON
请求方式: GET
请求示例: https://lyanzheng.cn/api.php?api=heartbeat&app=10000 复制示例 跳转示例
请求参数说明:
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | 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验证失败'
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
代码示例:
暂未添加示例代码