获取远程变量 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.get_variable_by_kami(card, '变量ID', '变量名称')
if result['success']:
    print(f"变量值: {result['value']}")

# 通过用户获取
result = verify.get_variable_by_user('username', 'password', '变量ID', '变量名称')

Node.js

// 通过卡密获取
const result = await verify.getVariableByKami(card, '变量ID', '变量名称');
if (result.success) console.log(`变量值: ${result.value}`);

Java

T3Verify.T3Result result = verify.getVariableByKami(card, "变量ID", "变量名称");
if (result.success) System.out.println("变量值: " + result.msg);

C#

var result = verify.GetVariableByKami(card, "变量ID", "变量名称");
if (result.Success) Console.WriteLine($"变量值: {result.Msg}");

PHP

$result = $verify->getVariableByKami($card, '变量ID', '变量名称');
if ($result['success']) echo "变量值: {$result['value']}\n";

会员要求

使用变量功能需要开发者开通会员。

单码卡密模式

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

用户模式

参数	类型	必填	说明
user	string	必填	用户名
pass	string	必填	密码
valueid	string	必填	变量 ID
valuename	string	必填	变量名称
t	number	条件必填	秒级 Unix 时间戳
s	string	条件必填	请求签名
safe_code	string	可选	数据验证码

成功响应

JSON 格式

{
  "code": "200",             // 状态码
  "msg": "这是变量值内容"     // 变量内容
}

文本格式

这是变量值内容

动态替换

变量内容中的 {t} 会被自动替换为当前服务器时间戳。

错误列表

业务错误

错误消息	原因
使用变量功能需要开发者开通会员	开发者未开通会员
卡密不可为空	单码模式未传 kami
用户名不可为空	用户模式未传 user
密码不可为空	用户模式未传 pass
变量ID不可为空	未传 valueid
变量名称不可为空	未传 valuename
卡密不存在 / 卡密被禁用 / 卡密未激活 / 卡密已到期	卡密状态异常
用户不存在 / 用户名或密码错误 / 用户被禁用	用户状态异常
请先充值后使用 / 用户使用时间已到期	用户未激活或已过期
变量数据不存在	变量 ID 或名称不匹配
变量被禁用	变量被后台禁用

通用错误

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