稳定、快速、高效的数据接口服务
请求参数说明
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 固定填写 ini |
| 应用 | app | 是 | GET | 填写后台应用的 APPID |
| 支付配置 | pay | 否 | GET | 提交该参数时会一并返回支付相关配置(pay_state/pay_url 等) |
| 时间戳 | t | 否 | GET/POST | 开启[时间差校验]时必须提交,服务端会校验与本地时间差 |
| 数据签名 | sign | 否 | GET/POST | 开启[数据签名]时必须提交,计算方式见开发文档 |
返回参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| code | Int | 状态码,200 表示成功 |
| msg | Object | 成功时返回配置对象,见下方字段 |
| msg.version | String | 应用当前版本号 |
| msg.version_info | String | 版本说明 |
| msg.app_update_show | String | 更新内容 |
| msg.app_update_url | String | 更新下载地址(蓝奏云链接会自动解析为直链) |
| msg.app_update_must | String | 是否强制更新,y 为强制 |
| msg.api_total | Int | 该接口累计调用次数 |
| msg.pay | Object | 仅当提交 pay 参数时返回,包含支付开关与通道配置 |
返回示例
{
"code": 200,
"msg": {
"version": "3.0.0",
"version_info": "全新版本上线,优化了加密性能",
"app_update_show": "1、修复若干问题\n2、提升稳定性",
"app_update_url": "https://example.com/app.apk",
"app_update_must": "n",
"api_total": 10240
},
"time": 1770000000,
"check": "e10adc3949ba59abbe56e057f20f883e"
}
错误码格式说明
| 名称 | 类型 | 说明 |
|---|---|---|
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
| 100 | String | 请绑定应用ID(未传 app 参数) |
| 101 | String | 应用不存在 |
| 102 | String | 应用已关闭 |
| 104 | String | 签名为空 |
| 105 | String | 数据过期(客户端时间与服务器时间差超出限制) |
| 106 | String | 签名有误 |
| 107 | String | 数据为空(加密模式下未提交 data) |
| 108 | String | 未发现时间变量(开启时间差校验但未提交 t) |
| 171 | String | 接口维护中 |
| 172 | String | 接口未添加或不存在 |
代码示例
// PHP 调用示例:获取应用配置
$appid = "你的APPID";
$appkey = "你的APPKEY";
$params = [
"api" => "ini",
"app" => $appid,
"pay" => "1", // 需要支付配置时提交
"t" => time(),
];
// 生成签名:按 键=值& 拼接后追加 APPKEY 取 MD5
ksort($params);
$str = "";
foreach ($params as $k => $v) { $str .= $k . "=" . $v . "&"; }
$params["sign"] = md5($str . $appkey);
$url = "https://你的域名/api.php?" . http_build_query($params);
$res = file_get_contents($url);
echo $res;