QQ凭证获取变量 POST

通过已绑定的 QQ 凭证（openid + access_token）获取远程变量的值，无需再传用户名密码。请求方法： POST　　Content-Type： application/x-www-form-urlencoded

SDK 调用示例

PythonNode.jsJavaC#PHPpython

result = verify.get_variable_by_qq('openid', 'access_token', '变量ID', '变量名称')
if result['success']:
    print(f"变量值: {result['value']}")

javascript

const result = await verify.getVariableByQq('openid', 'access_token', '变量ID', '变量名称');
if (result.success) console.log(`变量值: ${result.value}`);

java

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

csharp

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

php

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

前提条件用户需先通过 绑定QQ 接口完成绑定，或已通过 用户QQ登录 获得凭证。会员要求使用变量功能需要开发者开通会员。

请求参数

参数类型必填说明
openidstring必填QQ openid（32 位字母数字）
access_tokenstring必填QQ access_token（32 位字母数字）
valueidstring必填变量 ID
valuenamestring必填变量名称
tnumber条件必填秒级 Unix 时间戳
sstring条件必填请求签名
safe_codestring可选数据验证码

成功响应

JSON 格式文本格式jsonc

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

txt

这是变量值内容

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

错误列表

业务错误

错误消息原因
使用变量功能需要开发者开通会员开发者未开通会员
openid不可为空 / access_token不可为空凭证未传
openid只能为英文或数字 / access_token只能为英文或数字凭证含非法字符
openid格式错误 / access_token格式错误凭证长度不是 32 位
变量ID不可为空未传 valueid
变量名称不可为空未传 valuename
该QQ未绑定用户openid + access_token 未匹配到已绑定的账号
用户被禁用用户 active=0
请先充值后使用账号 end_time=0 且 mode=0（未激活）
用户使用时间已到期账号已过期且 mode=0
变量数据不存在变量 ID 或名称不匹配
变量被禁用变量被后台禁用

通用错误

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