基础地址: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 资源不存在