Open API / H5 注册

H5 注册并绑定推荐人

邀请落地页用。先发短信,再带邀请码注册。邀请码是海报里的 ZXS+众享号。H5 不要做 RSA2,也不要传 X-YS-*。

H5 无需鉴权

1. 查邀请人

GET/v1/h5/invite

测试 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 前缀。

json
{
  "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. 查手机号是否已注册

POST/v1/h5/phone/check

测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/phone/check

无需登录,不要带 X-YS-*。禁用或注销的账号 exists 仍为 true。软删除的档案不算已注册。

同一 IP 默认每分钟 20 次。超出后冻结 15 分钟,返回 code=429。

json
{
  "phone": "13800138000"
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "exists": false
  }
}

3. 发短信

POST/v1/h5/sms/code

测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/sms/code

json
{
  "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. 注册并绑定

POST/v1/h5/register

测试 URL:https://test-chat-live-open-go.gyyx.store/v1/h5/register

字段必填说明
phone是11 位手机号
code是6 位短信码
invite_code是海报邀请码,如 ZXS58033399
password否6-64 位登录密码。仅在本次新建账号时写入;手机号已有账号时忽略,不会改密码
json
{
  "phone": "13800138000",
  "code": "123456",
  "invite_code": "ZXS58033399",
  "password": "Abc123"
}

新号会创建本地账号并同步平台众享号,再把推荐人绑到邀请码对应的众享号。已有账号只做首次绑定,不会重复建号。

json
{
  "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环形推荐关系