H5 注册并绑定推荐人
邀请落地页用。先发短信,再带邀请码注册。邀请码是海报里的 ZXS+众享号。H5 不要做 RSA2,也不要传 X-YS-*。
1. 查邀请人
测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/invite?invite_code=ZXS58033399
落地页打开时用。也接受路径 /v1/h5/invite/ZXS58033399,以及 POST JSON {"invite_code":"ZXS58033399"}。不要带 /api/open 前缀。
{
"code": 0,
"message": "ok",
"data": {
"invite_code": "ZXS58033399",
"user_no": "58033399",
"nickname": "你是一个昵称",
"avatar": "https://cdn.example.com/a.png",
"referrer": {
"user_no": "58033399",
"nickname": "你是一个昵称",
"avatar": "https://cdn.example.com/a.png"
}
}
}
邀请码对不上本地用户时 code=4942。邀请码为空或格式不对时 code=4001。
2. 查手机号是否已注册
测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/phone/check
无需登录,不要带 X-YS-*。禁用或注销的账号 exists 仍为 true。软删除的档案不算已注册。
同一 IP 默认每分钟 20 次。超出后冻结 15 分钟,返回 code=429。
{
"phone": "13800138000"
}
{
"code": 0,
"message": "ok",
"data": {
"exists": false
}
}
3. 发短信
测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/sms/code
{
"phone": "13800138000",
"scene": "h5_register"
}
scene 只能是 h5_register。成功 data.expireSeconds 为有效秒数。验证码与 Home 登录短信共用同一 Redis key。同一 IP 的发码次数也与 Home 相同:sms.ip_window 秒内最多 sms.ip_limit 次(默认 60 秒 5000 次),超出返回 code=4002。不需要滑块。手机号已注册(含禁用)时不发短信,返回 code=4090、message=手机号已注册。
4. 注册并绑定
测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/register
| 字段 | 必填 | 说明 |
|---|---|---|
phone | 是 | 11 位手机号 |
code | 是 | 6 位短信码 |
invite_code | 是 | 海报邀请码,如 ZXS58033399 |
password | 否 | 6-64 位登录密码。仅在本次新建账号时写入;手机号已有账号时忽略,不会改密码 |
{
"phone": "13800138000",
"code": "123456",
"invite_code": "ZXS58033399",
"password": "Abc123"
}
新号会创建本地账号并同步平台众享号,再把推荐人绑到邀请码对应的众享号。已有账号只做首次绑定,不会重复建号。
{
"code": 0,
"message": "ok",
"data": {
"created": true,
"user_id": 30,
"user_no": "88812345",
"phone": "138****8000",
"invite_code": "ZXS58033399",
"referrer": {
"user_no": "58033399",
"nickname": "你是一个昵称",
"avatar": "https://cdn.example.com/a.png"
}
}
}
| code | 含义 |
|---|---|
| 4001 | 手机号 / 验证码 / 邀请码 / 密码长度无效 |
| 4090 | 手机号已注册(发短信时) |
| 4002 | 发短信过于频繁,与 Home 同一 IP 额度 |
| 429 | 查号过于频繁,同一 IP 冻结 15 分钟 |
| 4005 | 验证码错误 |
| 4006 | 验证码过期 |
| 4102 | 账号已禁用或注销 |
| 4940 | 众享号未同步,暂无法绑定 |
| 4941 | 推荐人服务未配置 |
| 4942 | 推荐人不存在或已注销 |
| 4944 | 不能绑自己 |
| 4945 | 环形推荐关系 |