注册与登录(全端统一)
Mac / Windows / Android / iOS 使用同一套登录与注册方式,不再区分「手机号登录」与「用户名登录」两套 UI。
- 登录:账号 + 密码(账号 = 用户名 / 已绑定手机号 / 已绑定邮箱)
- 注册:用户名 + 密码 + 图形验证码(同意协议)
- 不提供短信验证码登录(各端一致)
一、注册(桌面与手机同一流程)
1
打开客户端登录页,切换到「注册」。
2
填写用户名:字母开头,4–32 位,仅
a-z 0-9 _(服务端存小写)。
不能用纯手机号注册。
3
设置密码(至少 6 位)并确认一次。
4
填写图形验证码(点击图片可刷新)。
GET /api/auth/captcha
5
勾选《用户协议》与《隐私政策》。
6
POST /api/auth/register
{ username, password, captchaId, captchaCode, consentVersion }
→ accessToken,进入产品。
二、登录(桌面与手机同一流程)
1
标签为「账号」,输入框占位:用户名 / 手机号 / 邮箱。
2
POST /api/auth/login:
{ account, password }
3
电脑与手机请使用同一账号登录,设备才会出现在列表。
4
若开启 TOTP 2FA,再输入动态验证码。
三、绑定手机 / 邮箱(可选,登录后)
- 绑定后,可用该手机号或邮箱作为「账号」字段登录(仍用密码,不是短信登录)。
POST /api/auth/bind/phone·POST /api/auth/bind/email
四、错误码
| code | 说明 |
|---|---|
| CAPTCHA_INVALID | 图形验证码错误或过期 |
| USERNAME_TAKEN | 用户名已被占用 |
| BAD_CREDENTIALS | 账号或密码错误 |
| CONSENT_REQUIRED | 注册未同意协议 |
| PHONE_TAKEN / EMAIL_TAKEN | 绑定冲突 |
五、兼容说明
服务端历史短信接口可能仍保留,但正式客户端不再展示短信登录。 新用户与全端联调统一走账号密码。