查询单码卡密 POST

查询单码卡密的状态信息。

请求方法： POST　　Content-Type： application/x-www-form-urlencoded

💡 SDK 快速接入

官方 SDK 已支持此接口，您可以直接使用 SDK 一键调用，无需手动处理加密和签名。

PythonNode.jsJavaC#CC++PHPObjective-CSwiftWeb JS

对接示例也已支持此接口

Android 全屏验证Android 弹窗验证iOS 全屏验证iOS 弹窗验证Android JNI 命令行C++ 命令行

SDK 调用示例

Python

result = verify.query_kami(card)
if result['success']:
    print(f"激活状态: {result['use']}")
    print(f"到期时间: {result['end_time']}")
    print(f"剩余时间: {result['available']}秒")
    print(f"在线状态: {result['line']}")

Node.js

const result = await verify.queryKami(card);
if (result.success) {
    console.log(`激活状态: ${result.use}`);
    console.log(`到期时间: ${result.end_time}`);
    console.log(`剩余时间: ${result.available}秒`);
    console.log(`在线状态: ${result.line}`);
}

Java

T3Verify.T3Result result = verify.queryKami(card);
if (result.success) System.out.println(result.msg);

C#

var result = verify.QueryKami(card);
if (result.Success) Console.WriteLine(result.Msg);

PHP

$result = $verify->queryKami($card);
if ($result['success']) {
    echo "激活状态: {$result['use']}\n";
    echo "到期时间: {$result['end_time']}\n";
    echo "剩余时间: {$result['available']}秒\n";
    echo "在线状态: {$result['line']}\n";
}

与登录接口的区别

查询接口仅返回卡密基本信息，不会触发登录、不绑定设备、不生成 Token 和 statecode。

请求参数

参数	类型	必填	说明
kami	string	必填	单码卡密值
t	number	条件必填	秒级 Unix 时间戳
s	string	条件必填	请求签名
safe_code	string	可选	数据验证码

成功响应

JSON 格式

{
  "code": "200",                        // 状态码
  "state": "正常",                      // 卡密状态
  "use": "已激活",                      // 激活状态（已激活 / 未激活）
  "id": 1,                              // 单码卡密 ID
  "use_time": "2026-03-01 12:00:00",    // 使用（激活）时间
  "end_time": "2026-04-10 12:00:00",    // 到期时间
  "line_time": "2026-03-14 17:50:00",   // 最后在线时间
  "line": "在线",                       // 在线状态
  "amount": "30天",                      // 卡密时长描述
  "available": 2592000,                  // 剩余秒数
  "time": 1741700000,                    // 服务器时间戳
  "date": "202603111200"                // 服务器日期分钟
}

文本格式

获取成功:200
卡密状态:正常
激活状态:已激活
卡密ID:1
使用时间:2026-03-01 12:00:00
到期时间:2026-04-10 12:00:00
在线时间:2026-03-14 17:50:00
在线状态:在线
卡密时长:30天
剩余时间:2592000
当前时间:202603111200
当前时间戳:1741700000

错误列表

错误消息	原因
卡密不可为空	未传 kami
卡密不存在	卡密不存在
卡密被禁用	卡密被后台禁用
卡密已到期	卡密已过期
程序未开启 / 接口未开启	程序或接口未启用
时间戳参数不可为空	开启时间戳验证但未传 t
验证数据已失效，请重试	时间戳校验失败（排障指南）
签名参数不可为空	开启签名验证但未传 s
签名有误	签名校验失败