稳定、快速、高效的数据接口服务
请求参数说明
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 固定填写 getrc4 |
| 应用 | app | 是 | GET | 填写后台应用的 APPID |
| 应用ID | appid | 是 | GET | 需要获取 RC4 密钥的应用 ID(仅能获取自己名下的应用) |
| 时间戳 | t | 否 | GET/POST | 开启[时间差校验]时必须提交,服务端会校验与本地时间差 |
| 数据签名 | sign | 否 | GET/POST | 开启[数据签名]时必须提交,计算方式见开发文档 |
返回参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| code | Int | 200 表示成功 |
| msg | Object | 成功时返回密钥对象 |
| msg.rc4key | String | 该应用的 RC4 通信密钥 |
| time | Int | 服务器时间戳 |
| check | String | 二次校验值 |
返回示例
{
"code": 200,
"msg": {
"rc4key": "a1b2c3d4e5f6g7h8"
},
"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 | 接口未添加或不存在 |
| 201 | String | 获取 RC4Key 失败 |
| 200 | String | 无法获取他人 RC4Key(appid 不属于当前应用) |
代码示例
// PHP 调用示例:获取应用 RC4 密钥
$appid = "你的APPID";
$appkey = "你的APPKEY";
$params = [
"api" => "getrc4",
"app" => $appid,
"appid" => $appid,
"t" => time(),
];
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 = json_decode(file_get_contents($url), true);
echo "RC4 Key: " . $res["msg"]["rc4key"];