基础地址：http://kamimi.cn/api 或 http://localhost/api

请求格式：表单 application/x-www-form-urlencoded 或 application/json

1) 查询卡密状态

GET /card.php?action=query&code=卡密

复制

GET http://kamimi.cn/api/card.php?action=query&code=CARDABCDEF123456

2) 兑换卡密（消耗）

POST /card.php，参数：action=redeem, code, machine_code(必填), user_id(可选), username(可选)

复制

POST http://kamimi.cn/api/card.php
Content-Type: application/x-www-form-urlencoded

action=redeem&code=CARDABCDEF123456&machine_code=PC-ABC-001&user_id=u1001&username=%E5%BC%A0%E4%B8%89

复制

POST http://kamimi.cn/api/card.php
Content-Type: application/json

{
  "action": "redeem",
  "code": "CARDABCDEF123456",
  "machine_code": "PC-ABC-001",
  "user_id": "u1001",
  "username": "张三"
}

3) 验证机器码（客户端启动时）

用于已兑换的卡密在客户端启动时二次校验绑定机器码。

GET /card.php?action=verifyMachine&code=卡密&machine_code=机器码

复制

GET http://kamimi.cn/api/card.php?action=verifyMachine&code=CARDABCDEF123456&machine_code=PC-ABC-001

成功返回示例

{
  "success": true,
  "message": "卡密兑换成功",
  "data": {"card_value": "29.99", "card_type": "月卡"},
  "timestamp": "YYYY-MM-DD HH:MM:SS"
}

失败返回示例

{
  "success": false,
  "message": "卡密已被使用或已过期",
  "data": null,
  "timestamp": "YYYY-MM-DD HH:MM:SS"
}

状态码：200（成功），400（参数/业务失败），404（卡密不存在）

📦 一键复制全部对接信息

复制全部

【基础】
BASE: http://kamimi.cn/api

【查询卡密】
GET /card.php?action=query&code=CARDABCDEF123456

【兑换卡密（绑定机器码）】
POST /card.php (x-www-form-urlencoded)
action=redeem&code=CARDABCDEF123456&machine_code=PC-ABC-001&user_id=u1001&username=张三

POST /card.php (application/json)
{
  "action": "redeem",
  "code": "CARDABCDEF123456",
  "machine_code": "PC-ABC-001",
  "user_id": "u1001",
  "username": "张三"
}

【验证机器码】
GET /card.php?action=verifyMachine&code=CARDABCDEF123456&machine_code=PC-ABC-001

【返回格式】
{ success:boolean, message:string, data:object|null, timestamp:string }

【状态码】
200 成功；400 参数/业务失败；404 资源不存在