卡密心跳

接口地址: 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 接口未添加或不存在

代码示例:

暂未添加示例代码