GetVariable 获取变量

程序信息类查询入口：读取程序级别的变量。可指定 VarName 查单个变量，不传则返回全部变量。常用于把配置信息（如应用名、当前版本、上下架状态）下发到客户端。

项目	值
action	GetVariable
入口	Handle POST https://www.a7p.cn/api/verify/{ApiPassword}
是否计入验证统计	否

调用步骤

1. 完成 Init 握手，拿到 ApiPassword。
2. 拼接明文：action=GetVariable（查全部）或 action=GetVariable&VarName=app_version（查单个）。
3. RC4 加密 + MD5 签名，POST 到 Handle 接口。
4. code == 200 → 查单个返回 data.value；查全部返回 data.variables 对象。

请求参数

字段	类型	必填	说明
action	string	是	固定值 GetVariable
VarName	string	否	要查询的变量名。等价别名：Name。留空返回全部变量

明文示例：

# 查全部
action=GetVariable

# 查单个
action=GetVariable&VarName=app_version

变量清单

变量名	类型	说明
app_name	string	程序名称
app_version	string	程序版本号（缺省 1.0）
app_status	string	程序状态（后台存储值，如 approved/pending）

业务规则

• 传了 VarName 且该变量存在时，返回 { "value": <变量值> }。
• 不传 VarName 或变量不存在时，返回 variables 对象（包含 app_name / app_version / app_status 三个变量）。

请求示例

Python

# 复用 /api/handle 页面中的 handle() 与 rc4() 函数
API_PW = "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6"

# 查单个
r1 = handle(API_PW, "action=GetVariable&VarName=app_version")
if r1["code"] == 200:
    print("当前版本:", r1["data"]["value"])

# 查全部
r2 = handle(API_PW, "action=GetVariable")
if r2["code"] == 200:
    print("全部变量:", r2["data"]["variables"])

易语言

.版本 2

.子程序 A7_获取变量, 逻辑型
.参数 ApiPassword, 文本型
.参数 变量名, 文本型
.局部变量 TimeStamp, 文本型
.局部变量 加密参数, 文本型
.局部变量 Sign, 文本型
.局部变量 返回文本, 文本型
.局部变量 状态码, 文本型

TimeStamp ＝ 到文本 (时间_取现行时间戳 ())
加密参数 ＝ RC4加密 (ApiPassword, "action=GetVariable&VarName=" ＋ 变量名)
Sign ＝ 取数据摘要 (到字节集 (ApiPassword ＋ TimeStamp ＋ 加密参数))
返回文本 ＝ 到文本 (网页_访问 ("https://www.a7p.cn/api/verify/" ＋ ApiPassword, 1, "TimeStamp=" ＋ TimeStamp ＋ "&Sign=" ＋ Sign ＋ "&Data=" ＋ 加密参数))

状态码 ＝ JSON_解析 (返回文本, "code")
.判断开始 (状态码 ＝ "200")
    信息框 ("变量值：" ＋ JSON_解析 (返回文本, "data.value"), 0, )
.默认
    信息框 ("查询失败：" ＋ JSON_解析 (返回文本, "message"), 0, )
.判断结束
返回 (假)

成功响应

查单个变量

{
  "code": 200,
  "message": "success",
  "data": { "value": "1.0" }
}

查全部变量

{
  "code": 200,
  "message": "success",
  "data": {
    "variables": {
      "app_name": "示例程序",
      "app_version": "1.0",
      "app_status": "approved"
    }
  }
}

字段	类型	说明
value	string	单个变量查询时的返回值
variables	object	全部变量查询时返回的对象，含 app_name / app_version / app_status

错误码

该接口本身不校验业务参数，失败通常由握手层错误引起（如 1001 程序不存在、1010 签名错误、1012 程序未审核通过）。完整列表见错误码对照表。

相关文档

• GetLatestVersion 获取最新版本
• GetBulletin 获取公告
• SDK 实现：易语言 · Python