开发者对接 API 文档
API 1卡密登录与验证
在用户打开软件并输入卡密登录时调用。如果是新卡密则自动激活;老卡密则自动校验到期时间、设备和IP变动。
请求地址: {{ apiBaseUrl }}?action=verify_card
请求参数 JSON:
{
"app_key": "你程序的AppKey (必填)",
"card_key": "用户输入的卡密 (必填)",
"device_id": "获取到的设备机器码 (如果后台开启了绑机,则必填)",
"timestamp": 1735689600 // 当前客户端10位时间戳 (如果后台开启了时间差校验,则必填)
}
成功返回 JSON:
{
"code": 1, // 这里会返回你在后台自定义的[登录状态码]
"msg": "验证成功",
"data": {
"expires_at": 1735689600, // 卡密到期时间戳(秒)
"notice": "你的应用公告", // 仅当后台开启了应用公告时才有内容
"crypto_enabled": true, // 后台是否开启了全局加密
"crypto_type": "rc4" // 如果开启了加密,这里是加密算法的名称
}
}
API 2心跳保活检测
登录成功后,软件应在后台定时(如每隔 60 秒)循环请求此接口,以确保卡密没有中途到期或被其他设备顶号登录。
请求地址: {{ apiBaseUrl }}?action=heartbeat
请求参数 JSON:
{
"app_key": "你程序的AppKey",
"card_key": "当前使用的卡密",
"device_id": "当前设备机器码"
}
成功返回 JSON:
{
"code": 1,
"msg": "心跳正常",
"data": []
}
防破解建议:如果心跳返回 code 变为 0,或者网络请求失败,软件应立即强制结束自身进程(ExitProcess)。