POST /api/v1/card-keys/unbind
Content-Type: application/json
请求体与 verify 相同(公共请求体)。device_name、client_meta 可省略。APK 相关字段可带但当前不强制校验。
成功时 ApiResponse.data:
{
"code": 0,
"message": "success",
"data": { "ok": true },
"timestamp": 1720857600
}
本接口仅适用于 Volt 卡密云服务。自行搭建服务端不适用(服务端 SDK 尚未开放)。
在策略 allow_unbind = true 时,终端可主动释放当前设备绑定,便于换机或用户主动登出。
调用前提:
- 应用可用(
active 且未封禁)
- 卡密仍有效
- 该指纹已有活跃绑定
- 发卡策略允许客户端解绑
若策略禁止解绑,应引导用户联系发卡方;发卡方可在控制台执行强制解绑(管理面接口,不在本分类)。
curl -X POST https://api.example.com/api/v1/card-keys/unbind \
-H "Content-Type: application/json" \
-d '{
"app_id": "ck_a1b2c3d4",
"code": "GAME-XXXX-XXXX",
"device_fingerprint": "stable-device-id-001"
}'
- 解绑成功后,同一设备需重新
verify 才能使用与心跳
- 解绑不会删除卡密本身,仅释放该设备占用的绑定槽
- 换机流程建议:旧设备
unbind(若允许)→ 新设备 verify