卡密公开接口
面向客户端 / SDK 的卡密终端公开接口。三接口共用公共请求体。
本分类文档描述 Volt 卡密云公开接口:终端侧完成验证绑定、心跳保活与主动解绑。
三接口均为 HTTP JSON、无需用户 JWT;会话凭 app_id(或应用短码)+ 卡密明文 + 设备指纹识别。请先阅读下方 公共请求体,再进入各接口页。
重要:适用范围
- 本系列接口仅适用于使用 Volt 提供的卡密云服务(在控制台创建发卡应用、生成卡密后,由终端调用本站公开 API)。
- 自行搭建服务端不适用。独立服务端 / 私有化卡密服务端 SDK 尚未开放;请勿将本文档当作自建后端契约。
- 发卡方管理面(创建应用、策略、批量制卡等)走控制台登录态 API,不属于本分类。
接入前请确认:
app_code(或应用 UUID)、数据密钥与验签公钥(若策略启用加密/签名)device_fingerprint(跨进程不变)应用须处于 active 且未被封禁,否则三接口均拒绝。
三接口共用同一请求体形状。heartbeat / unbind 可省略 device_name、client_meta。
codedevice_fingerprint 不稳定会导致占满设备槽或心跳报「未绑定」