🔑 小牛马卡密系统 API v3.0
基础URL：/api/index.php · 所有接口需带 app 参数（通用接口除外）
🔵 卡密模式
传统卡密验证
🔷 账户模式 NEW
用户名密码登录
🟣 通用
更新/公告
📌 v3.0 新特性：
账户登录 · 充值卡充值 · 解绑扣天 · 单卡(单账户)登录
🟣 通用接口
检查更新 GET
action=check_update&app=xxx&version=1.0.0
同时返回公告（如启用）
获取公告 GET/POST
action=get_notice&app=xxx
🔵 卡密模式
验证卡密 GET/POST 自动激活
action=verify&app=xxx&kamis=xxxx-xxxx&hardware_id=xxx
参数：kamis(卡密) hardware_id(设备标识,可选)
功能：验证卡密有效性。卡密未使用则自动激活。支持设备绑定检查。
返回：product/expire_at/devices/max_devices/notice
激活卡密 POST
action=use&app=xxx
参数：kamis hardware_id (可选)
返回：product/duration_days/expire_at/token/notice
心跳 GET/POST
action=heartbeat&app=xxx&kamis=xxx&hardware_id=xxx
软件运行时定期调用，维持在线状态。建议每5~10分钟一次。
解绑设备 POST NEW
action=unbind&app=xxx
参数：kamis hardware_id
⚠️ 自动扣除天数（每个软件独立设置，默认3天，防刷）
卡密信息 GET
action=info&app=xxx&kamis=xxx
返回卡密状态、绑定设备列表等
🔷 账户模式 全部新增
💡 账户模式工作流：注册账户 → 买卡密(充值卡) → 用充值卡给账户充值
注册账户 POST
action=account_register&app=xxx
参数：username password（密码自动sha256）
要求：用户名4~32位，密码≥6位
账户登录 POST
action=account_login&app=xxx
参数：username password hardware_id(可选)
✔ 支持多设备绑定
✔ 单账户可多设备登录（可设置设备上限）
返回：token/expire_at/devices/max_devices/notice
充值卡充值 POST NEW
action=recharge&app=xxx
参数：username kamis
⭐ 用卡密给账户续时长！
支持在现有到期时间上叠加
返回：added_days/expire_at
账户心跳 GET/POST
action=account_heartbeat&app=xxx&username=xxx&hardware_id=xxx
账户解绑设备 POST
action=account_unbind&app=xxx
参数：username password hardware_id
⚠️ 自动扣天（每个软件独立设置，需密码验证）
账户信息 POST
action=account_info&app=xxx
参数：username password
返回：账户详情、设备列表、充值记录
🆕 管理后台新页面
| 页面 |
说明 |
/admin/accounts.php | 账户管理（查看/冻结/重置密码） |
/admin/recharges.php | 充值记录（按软件/账户筛选） |
💻 客户端集成示例
Python 版
# 卡密模式 - 激活
import requests
r = requests.post("https://你的域名/api/index.php", data={
"app": "myapp_v1",
"action": "use",
"kamis": "ABCD-1234-EFGH-5678",
})
print(r.json())
# 卡密模式 - 验证(含设备绑定)
r = requests.get("https://你的域名/api/index.php", params={
"app": "myapp_v1",
"action": "verify",
"kamis": "ABCD-1234-EFGH-5678",
"hardware_id": "机器码获取.get_machine_id()"
})
# 账户模式 - 登录
r = requests.post("https://你的域名/api/index.php", data={
"app": "myapp_v1",
"action": "account_login",
"username": "用户输入的用户名",
"password": "用户输入的密码sha256",
"hardware_id": "机器码"
})
# 账户模式 - 充值
r = requests.post("https://你的域名/api/index.php", data={
"app": "myapp_v1",
"action": "recharge",
"username": "已有账户",
"kamis": "充值卡卡密"
})
# 账户模式 - 解绑
r = requests.post("https://你的域名/api/index.php", data={
"app": "myapp_v1",
"action": "account_unbind",
"username": "用户名",
"password": "密码sha256",
"hardware_id": "要被解绑的设备标识"
})
📋 通用错误码
| code | 说明 |
|---|
| 0 | 成功 |
| -1 | 参数错误/系统错误 |
| 1 | 卡密/账户不存在 |
| 2 | 已使用/密码错误/设备未绑定 |
| 3 | 已冻结/被封 |
| 4 | 卡密已冻结 |
| 5 | 已过期 |
| 6 | 设备数达上限 |