Appearance
修改远程变量 POST
修改远程变量的值。
请求方法:
POSTContent-Type:application/x-www-form-urlencoded
💡 SDK 快速接入
官方 SDK 已支持此接口,您可以直接使用 SDK 一键调用,无需手动处理加密和签名。
SDK 调用示例
python
# 通过卡密修改
result = verify.modify_variable_by_kami(card, '变量ID', '新内容')
if result['success']:
print(f"{result['msg']}")javascript
const result = await verify.modifyVariableByKami(card, '变量ID', '新内容');
if (result.success) console.log(result.msg);java
T3Verify.T3Result result = verify.modifyVariableByKami(card, "变量ID", "新内容");
if (result.success) System.out.println(result.msg);csharp
var result = verify.ModifyVariableByKami(card, "变量ID", "新内容");
if (result.Success) Console.WriteLine(result.Msg);php
$result = $verify->modifyVariableByKami($card, '变量ID', '新内容');
if ($result['success']) echo $result['msg'] . "\n";年度会员要求
使用修改变量功能需要开发者开通 年度会员。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
valueid | string | 必填 | 变量 ID |
valuecontent | string | 必填 | 新的变量内容 |
t | number | 条件必填 | 秒级 Unix 时间戳 |
s | string | 条件必填 | 请求签名 |
safe_code | string | 可选 | 数据验证码 |
程序级接口
此接口为程序级操作,直接修改变量内容,无需传入卡密或用户凭证。
成功响应
jsonc
{
"code": "200", // 状态码
"msg": "更新成功" // 结果消息
}txt
更新成功错误列表
业务错误
| 错误消息 | 原因 |
|---|---|
使用修改变量功能需要开发者开通年度会员 | 未开通年度会员 |
变量ID不可为空 | 未传 valueid |
变量内容不可为空 | 未传 valuecontent |
变量数据不存在 | 变量 ID 不匹配 |
变量被禁用 | 变量被后台禁用 |
通用错误
| 错误消息 | 原因 |
|---|---|
程序未开启 / 接口未开启 | 程序或接口未启用 |
时间戳参数不可为空 | 开启时间戳验证但未传 t |
验证数据已失效,请重试 | 时间戳校验失败(排障指南) |
签名参数不可为空 | 开启签名验证但未传 s |
签名有误 | 签名校验失败 |