稳定、快速、高效的 数据接口服务
当前接口状态 · 正常
卡密心跳
接口地址: https://yz.spcloud.top/api.php?api=heartbeat
返回格式: JSON
请求方式: GET/POST
请求示例: 域名/api.php?api=heartbeat&app=10000 复制示例 跳转示例
请求参数说明:
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 填写heartbeat |
| 应用 | app | 是 | GET | 填写后台应用APPID |
| 卡密 | kami | 是 | GET/POST | 填写提交的卡密 |
| 设备码 | markcode | 是 | GET/POST | 如果开启了[验证设备]需提交此项 |
| 时间戳 | 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": 201,
"msg": "心跳请求失败,卡密已到期",
"time": 1704023240,
"check": "a58c19f1d60ab53a6e51dd41efff58b1"
}
//如未登录卡密就开始心跳请求
{
code: 112,
msg: '心跳失败,Token已失效',
time: 1705140355,
check: '00ec3bfa0b472ea190384891f5a0b6c0'
}
//当服务端在指定时间未收到心跳请求
{
code: 110,
msg: '心跳超时,未在有效时间内请求心跳',
time: 1705140355,
check: '00ec3bfa0b472ea190384891f5a0b6c0'
}
//退出卡密心跳请求
{
"code": 200,
"msg": {
"kami": "123456",
"markcode": "BFEBFBFF000306C31079282276",
"logout_time": "2026-01-21 19:46:42",
"message": "卡密已成功退出登录"
},
"time": 1768996002,
"check": "cba68d06beca0b76c76d6de68e1bc334"
}
149,'心跳请求失败,卡密不存在'
150,'心跳请求失败,卡密已登录其它设备'
151,'心跳请求失败,卡密已被禁用'
169,'心跳请求失败,ip验证失败'
错误码格式说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
代码示例:
暂未添加示例代码