稳定、快速、高效的数据接口服务
请求参数说明
| 名称 | 变量 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
| 接口 | api | 是 | GET | 固定填写 userreg |
| 应用 | app | 是 | GET | 填写后台应用的 APPID |
| 用户账号 | user | 是 | GET/POST | 5~11 位,仅支持字母、数字、下划线,不支持中文及特殊字符 |
| 用户密码 | password | 是 | GET/POST | 6~18 位,支持字母数字及 . * _ - |
| 用户QQ | 是 | GET/POST | 用户 QQ 号,同一应用内不可重复 | |
| 用户昵称 | name | 否 | GET/POST | 不填则默认为「这个人没有名字!」 |
| 邀请人 | inv | 否 | GET/POST | 填写邀请人的 UID |
| 时间戳 | t | 否 | GET/POST | 开启[时间差校验]时必须提交,服务端会校验与本地时间差 |
| 数据签名 | sign | 否 | GET/POST | 开启[数据签名]时必须提交,计算方式见开发文档 |
返回参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| code | Int | 200 注册成功,201 注册失败 |
| msg | String | 返回信息 |
| time | Int | 服务器时间戳 |
| check | String | 二次校验值 |
返回示例
{
"code": 200,
"msg": "注册成功",
"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 | 接口未添加或不存在 |
| 109 | String | 请填写QQ |
| 110 | String | 请填写账号 |
| 111 | String | 请填写密码 |
| 115 | String | 账号已存在 |
| 116 | String | 账号不合法(需 5~11 位字母数字下划线) |
| 117 | String | 该 IP 已注册 |
| 119 | String | 密码不合法(需 6~18 位) |
| 174 | String | 该 QQ 已存在 |
代码示例
// PHP 调用示例:用户注册
$appid = "你的APPID";
$appkey = "你的APPKEY";
$params = [
"api" => "userreg",
"app" => $appid,
"user" => "test001",
"password" => "abc12345",
"qq" => "100000001",
"name" => "测试用户",
"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);
echo file_get_contents($url);
// ------- Lua 调用示例 -------
-- local url = "https://你的域名/api.php?api=userreg&app="..APPID
-- .."&user=test001&password=abc12345&qq=100000001&t="..os.time()
-- .."&sign="..md5("user=test001&password=abc12345&qq=100000001&t="..os.time().."&"..APPKEY)
-- ggo.makeRequest(url)