开发者文档

一、核心流程

所有语言（Python / 易语言 / C++ / Java / C# / Go / PHP / JavaScript / 按键精灵）的对接原理完全一致：一次 HTTP 请求，返回一个字符串。

你的软件  ──①  发送卡密 + 设备码 ──▶  迅胜卡密 API
你的软件  ◀── ②  返回验证结果（成功/失败 + 剩余时间 + 签名） ──  API

二、请求格式

GET https://jm.1009.cloud/kami/{用户名}/check.php?card=卡密&mac=设备码&app=应用名&heart=1&t=时间戳

三、返回格式

// ✅ 成功示例
ok|valid|30|43200|1791599357|1789007357|sign=1b7696301b90c7a86880e946e777fc81

// ❌ 失败示例
error|expired|1789007357|sign=...

四、返回码说明

五、签名机制（防篡改）

返回结果带 MD5 签名，客户端必须验签通过才认可结果，防止中间人篡改。

# 原始数据（去掉 |sign= 之后的部分）
body = "ok|valid|30|43200|1791599357|1789007357"

# 待签名字符串 = 原始数据 + 你的签名密钥
str = body + SIGN_KEY

# 签名
sign = md5(str)

# 校验：本地算出的 sign 必须等于服务端返回的 sign

六、时间戳防重放

ts  = 服务端返回的时间戳
now = 当前 UTC 时间戳
if (now - ts) > 120:   # 超过 120 秒视为过期
    拒绝

✅ 签名校验 → 防篡改　　✅ 时间戳校验 → 防重放。两者都通过，才认可验证结果。

七、多语言示例

Python

import requests, hashlib, time

USER, APP, SIGN_KEY = "你的用户名", "a", "你的签名密钥"
URL = f"https://jm.1009.cloud/kami/{USER}/check.php"

def check_card(card, mac):
    params = {"card": card, "mac": mac, "app": APP, "heart": 1, "t": int(time.time() * 1000)}
    raw = requests.get(URL, params=params, timeout=8).text.strip()

    body, _, sign = raw.rpartition("|sign=")
    if hashlib.md5((body + SIGN_KEY).encode()).hexdigest() != sign:
        return False, "签名校验失败"

    if body.startswith("ok"):
        return True, body.split("|")[2] + " 天"
    return False, body

C# / .NET

using var http = new HttpClient();
long ts = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
string url = $"{URL}?card={card}&mac={mac}&app={APP}&heart=1&t={ts}";
string raw = http.GetStringAsync(url).Result.Trim();

int i = raw.LastIndexOf("|sign=");
string body = raw[..i], sign = raw[(i + 6)..];

using var md5 = MD5.Create();
string local = Convert.ToHexString(md5.ComputeHash(Encoding.UTF8.GetBytes(body + SIGN_KEY))).ToLower();
bool ok = local == sign && body.StartsWith("ok");

Go

q := url.Values{"card": {card}, "mac": {mac}, "app": {APP}, "heart": {"1"},
    "t": {fmt.Sprint(time.Now().UnixMilli())}}
resp, _ := http.Get(URL + "?" + q.Encode())
b, _ := io.ReadAll(resp.Body)
raw := strings.TrimSpace(string(b))

idx := strings.LastIndex(raw, "|sign=")
body, sign := raw[:idx], raw[idx+6:]
sum := md5.Sum([]byte(body + SIGN_KEY))
ok := hex.EncodeToString(sum[:]) == sign && strings.HasPrefix(body, "ok")

更多语言（易语言 / Java / C++ / PHP / JavaScript / 按键精灵）的完整示例，登录后台后可在「对接代码」页一键复制（已自动填入你的用户名与应用名）。

八、扩展接口

免费开通，获取你的接口地址 →