开发文档

[示例]Sign签名计算方式

已注册普通注册为例：

代码示例：

Sign = 取MD5值("user=" + 编辑框_user.内容 + "&password=" + 编辑框_mima.内容 + "&inv=" + 编辑框_inv.内容 + "&markcode=" + 机器码 + "&t=" + 取现行时间戳(2) + "&" + APPKEY)

📘 心跳机制对接流程详解（新功能）

心跳机制用于：① 客户端会话保活、② 后台实时在线人数统计、③ 卡密有效性二次检查、④ IP地域分布地图。强烈建议在登录接口成功之后立即启动。

🗺️ 整体对接流程（4步）

⚡ 接口要点速查

🐍 最少可用 Python 代码（可直接复制运行验证）

替换 BASE_URL / APP_ID / KAMI / MARKCODE 后即可运行。完整代码与 curl / 伪代码版本，见心跳文档的 [demo] 子页。

import time, requests, hashlib

BASE_URL = "http://你的域名/api.php"
APP_ID   = "10001"          # 站长后台应用列表中的 appid
APP_KEY  = "你的APPKEY"     # 应用KEY
KAMI     = "AABB-CCDD-EEFF-0001"   # 卡密登录返回的kami
MARKCODE = hashlib.md5(b"my-pc").hexdigest()  # 本机机器码(示例)

def sign_ts():
    t = str(int(time.time()))
    # sign = md5(post键值串 + "&" + APPKEY)，最小示例kami+markcode
    raw = f"kami={KAMI}&markcode={MARKCODE}&t={t}&{APP_KEY}"
    return t, hashlib.md5(raw.encode()).hexdigest()

def heartbeat_once():
    t, s = sign_ts()
    r = requests.post(f"{BASE_URL}?api=heartbeat&app={APP_ID}", data={
        "kami": KAMI, "markcode": MARKCODE, "t": t, "sign": s
    }, timeout=8).json()
    code = r.get("code", -1)
    print(f"[心跳] code={code} msg={r.get('msg')}")
    if code == 200:
        m = r["msg"] if isinstance(r["msg"], dict) else {}
        return int(m.get("interval", 60)), None          # 继续
    elif code in (180, 181, 201):
        return None, f"致命错误 code={code}，退出登录"     # 停止
    else:
        return 30, f"可重试 code={code}"                  # 退避重试

# 主循环
fail_cnt = 0
while True:
    nxt, err = heartbeat_once()
    if err:
        fail_cnt = fail_cnt + 1 if "重试" in err else 99
        if fail_cnt >= 3: print(err); break
    else:
        fail_cnt = 0
    time.sleep(nxt or 60)

[示例]SDK及工具下载