腾飞博客云验证

接口地址： httpss://dzzg.club/api.php?api=heartbeat

返回格式：

请求方式：

请求示例：

请求参数说明：

说明：

1. kami 和 appuser 必须提交其中一个（根据你的登录方式选择），不能两个同时为空
2. markcode 必须与登录时一致，否则会当成新会话，导致在线人数虚高
3. 心跳频率建议使用返回的 interval 值，默认60秒，不要低于10秒（过于频繁会被封IP）
4. 如果接口返回code非200，请根据错误码进行处理（如过期则提示用户）
5. 客户端程序退出前可不主动登出，超过timeout时间（默认180秒）未心跳服务器自动判定为离线

返回参数说明：

msg 对象字段 (code=200时)：

返回示例：

 重要提示

 开始前请先完成：

 1. 在站点根目录执行 install_heartbeat.sql 导入数据表和配置

 2. 进入管理员后台 → 系统设置 → 心跳配置（set.php?mod=heartbeat）确认已启用

 3. 在应用管理中确认应用的"心跳开关"已开启（默认开启）


 接口调用示例（易语言 / 火山 / Lua通用逻辑）
' ================================================
' 步骤1：先正常登录（kmlogon 或 userlogon）
' ================================================
登录结果 = 登录("kmlogon", 应用ID, 卡密, 机器码)
如果 登录结果.code ≠ 200 则 
    提示("登录失败:" + 登录结果.msg)
    结束程序
结束如果
VIP时间 = 登录结果.msg.vip  ' 保存卡密到期时间

' ================================================
' 步骤2：启动心跳定时器（建议首次登录后立即发一次心跳）
' ================================================
子程序 心跳_执行()
    变量 参数 = "api=heartbeat&app=" + 到文本(应用ID)
    变量 提交 = "kami=" + 卡密 + "&markcode=" + 机器码
    变量 返回值 = HTTP访问("https://你的域名/api.php?" + 参数, 提交, 方法_POST)
    变量 结果 = JSON解析(返回值)
    
    如果 结果.code = 200 则
        ' 心跳成功：根据服务器返回值动态调整下次心跳间隔
        下次间隔 = 结果.msg.interval  ' 建议使用服务器返回的interval值
        在线人数 = 结果.msg.online_count
        下次心跳时间 = 结果.msg.next_heartbeat
        UI.显示("在线:" + 到文本(在线人数) + "人")
    否则
        ' 心跳失败：根据错误码处理
        判断 结果.code
            201: 提示("卡密已过期，程序即将退出"); 结束程序
            151: 提示("卡密已被禁用"); 结束程序
            169: 提示("IP不一致，已被踢出"); 结束程序
            180: 提示("服务端未启用心跳"); 停止定时器 ' 不影响使用
            默认:  日志("心跳失败 code=" + 到文本(结果.code) + " " + 结果.msg)
        结束判断
    结束如果
结束子程序

' ================================================
' 步骤3：定时器设置
' ================================================
首次调用(心跳_执行)  ' 登录后立刻执行1次，确保进入在线列表
设置定时器(心跳_执行, 下次间隔 * 1000)  ' 毫秒，默认60秒

' ================================================
' 步骤4（可选）：程序退出时可以最后发送一个离线提示
' ================================================
' 实际无需调用登出接口，超过timeout服务器自动判离线，
' 但是你可以把定时器间隔在程序退出时取消，避免后台残留请求。



 CURL命令行测试示例
curl -X POST "https://你的域名/api.php?api=heartbeat&app=10001" \
  -d "kami=MoamXBeiChen&markcode=test-machine-code-001"



 Python 调用示例
import time
import requests
import hashlib

API_BASE = "https://你的域名/api.php"
APPID = 10001
KAMI = "你的卡密"
MARKCODE = "测试设备码001"

def heartbeat():
    """发送一次心跳，返回 (是否成功, 建议下次间隔秒数, 错误信息)"""
    params = {"api": "heartbeat", "app": APPID}
    data = {"kami": KAMI, "markcode": MARKCODE}
    try:
        r = requests.post(API_BASE, params=params, data=data, timeout=8)
        j = r.json()
        if j["code"] == 200:
            return True, j["msg"]["interval"], None, j["msg"]["online_count"]
        else:
            return False, 60, f"code={j['code']} {j['msg']}", 0
    except Exception as e:
        return False, 60, f"网络异常:{str(e)}", 0

if __name__ == "__main__":
    print("[BC云验证] 心跳测试")
    while True:
        ok, interval, err, online = heartbeat()
        if ok:
            print(f"✅ 心跳OK | 下次{interval}s后 | 当前在线:{online}人")
        else:
            print(f"❌ 心跳失败: {err}")
            if "卡密已到期" in err or "禁用" in err:
                break  # 致命错误退出
        time.sleep(interval)