通过单码卡密获取云端变量
通过单码卡密获取云端变量 API
基本信息
/v3/single_get_variable/{appid}请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| card_code | string | 是 | 卡密 |
| variable_id | string | 是 | 变量ID |
| variable_name | string | 是 | 变量名称 |
| timestamp | int | 条件必填 | Unix时间戳 |
| sign | string | 条件必填 | 请求签名 |
请求示例
{
"card_code": "ABC123DEF456",
"variable_id": "3337",
"variable_name": "config",
"timestamp": 1699999999,
"sign": "abc123..."
}成功响应 (200)
{
"code": 200,
"message": "成功",
"data": {
"variable_id": 3337,
"variable_name": "config",
"variable_content": "key1=value1&key2=value2&time=1699999999"
},
"timestamp": 1699999999,
"nonce": "abc123...",
"sign": "def456..."
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| variable_id | int | 变量ID |
| variable_name | string | 变量名称 |
| variable_content | string | 变量内容{t} 占位符会被替换为当前时间戳 |
错误响应
| 错误码 | 错误消息 | 说明 |
|---|---|---|
| 403 | 需要VIP权限 | 程序开发者VIP已到期，无法使用此功能 |
| 404 | 卡密不存在 | 卡密不存在 |
| 405 | 卡密已禁用 | 卡密已被封禁 |
| 406 | 卡密已过期 | 卡密已到期 |
| 407 | 卡密未激活 | 卡密还未首次登录 |
| 420 | 变量不存在 | 变量ID或名称不正确 |
| 421 | 变量已禁用 | 变量已被停用 |
| 422 | 参数错误 | 缺少必要参数 |
C++ SDK调用示例
方法签名
基础用法
配置文件管理示例
开关控制示例
变量内容占位符
{t} 占位符
{t} 会被自动替换为当前时间戳。url=http://example.com/api?time={t}&key=abc123url=http://example.com/api?time=1699999999&key=abc123使用场景
1. 云端配置管理
2. 功能开关控制
3. 公告/消息推送
4. 动态资源地址
注意事项
重要提示 1.此功能需要程序开发者开通VIP权限 2.必须先登录（调用single_login） 3.variable_id和variable_name必须同时匹配 4.变量内容中的 {t}会自动替换为当前时间戳5.变量内容建议使用key=value格式，方便解析 6.如果返回空字符串，检查errorMsg判断是获取失败还是内容为空
错误处理
修改于 2025-11-10 21:07:45