单码卡密解绑机器码 API

基本信息

接口路径: /v3/single_unbind/{appid}

请求方法: POST

是否需要登录: 是

功能说明: 解绑当前设备，换绑到新设备（会扣除时间）

请求参数

参数名	类型	必填	说明
card_code	string	是	卡密（激活码）
device_code	string	否	新的设备标识不传则只解绑不换绑
timestamp	int	条件必填	Unix时间戳
sign	string	条件必填	请求签名

请求示例

{
    "card_code": "ABC123DEF456",
    "device_code": "NEW_DEVICE_12345",
    "timestamp": 1699999999,
    "sign": "abc123..."
}

成功响应 (200)

{
    "code": 200,
    "message": "解绑成功",
    "data": null,
    "timestamp": 1699999999,
    "nonce": "abc123...",
    "sign": "def456..."
}

错误响应

错误码	错误消息	说明
404	卡密不存在	卡密不存在
405	卡密已禁用	卡密已被封禁
406	卡密已过期	卡密已到期
407	卡密未激活	卡密还未首次登录，无需解绑
411	机器码验证未开启	程序未开启设备验证，无法解绑
412	解绑功能未开启	程序未开启解绑功能
416	设备相同	新设备与旧设备相同，无需解绑
417	解绑次数已达上限	解绑次数用完
418	解绑后将到期	扣除时间后剩余时长不足
419	解绑失败	数据库更新失败
422	参数错误	缺少必要参数

C++ SDK调用示例

方法签名

基础用法

完整解绑流程

只解绑不换绑

解绑机制说明

扣除时间

解绑会扣除一定时长，具体扣除多少由程序开发者设定。

示例：

原到期时间：2025-12-31 23:59:59（剩余30天）
扣除时长：3小时
解绑后到期时间：2025-12-31 20:59:59（剩余29天21小时）

解绑次数限制

解绑次数有限制，用完后无法再解绑。

限制类型：

总次数限制 - 累计解绑次数上限

时间段限制 - X小时内最多解绑Y次

解绑条件

程序必须满足：

✅ 开启了设备验证（mackg）

✅ 开启了解绑功能（changekg）

卡密必须满足：

✅ 卡密存在且未禁用

✅ 卡密已激活（已登录过）

✅ 卡密未过期

✅ 解绑次数未达上限

✅ 扣除时间后剩余时长充足

注意事项

重要提示
1.
解绑会扣除时间（具体扣除多少请咨询程序开发者）
2.
解绑次数有限制，用完后无法再解绑
3.
程序必须开启设备验证和解绑功能
4.
解绑成功后，登录状态会清除，需要重新登录
5.
如果程序未开启解绑功能，接口会返回412错误

单码卡密解绑机器码

单码卡密解绑机器码 API#

基本信息#

请求参数#

请求示例#

成功响应 (200)#

错误响应#

C++ SDK调用示例#

方法签名#

基础用法#

完整解绑流程#

只解绑不换绑#

解绑机制说明#

扣除时间#

解绑次数限制#

解绑条件#

注意事项#

错误处理建议#