DEVELOPER DOCUMENTATION
把授权接入
你的下一款软件。
标准 HTTP API，支持 C++、C#、按键精灵、易语言以及任何能发送请求的语言。
快速开始
- 在控制台创建应用，获得
app_key和独立app_secret。 - 在应用内生成卡密，把卡密交给用户。
- 客户端提交卡密和设备标识，激活成功后定时发送心跳。
激活接口
推荐使用 JSON POST：
POST https://freekami.com/api/v1/activate
{"app_key":"fk_xxx","code":"授权卡密","device_id":"设备标识"}
成功返回 session_token、expires_at 和心跳间隔。
兼容旧式 GET：
GET /kami/{用户标识}/check.php?card=卡密&mac=机器码&app=应用名&heart=1&t=时间戳
心跳与验证
POST https://freekami.com/api/v1/heartbeat
{"session_token":"会话令牌","device_id":"设备标识"}
建议每 55～60 秒发送一次。会话失效、卡密冻结或到期时，服务端会返回错误。
签名规则
兼容接口返回内容末尾带 MD5 签名：MD5(业务数据 + app_secret)。生产客户端应校验时间戳、签名和设备标识；不要把平台 JWT 主密钥放入客户端。
语言示例
C#
using var http = new HttpClient();
+var body = JsonContent.Create(new { app_key="APP_KEY", code="CARD", device_id="DEVICE" });
+var r = await http.PostAsync("https://freekami.com/api/v1/activate", body);
C++ / 按键精灵 / 易语言
使用 HTTP POST 组件发送相同 JSON；完整模板见 SDK.md。