POST /api/v1/users/register
先调用 发送验证码(purpose=register)获取验证码,再调用此接口完成注册。
使用邮箱注册时,注册成功后邮箱即标记为已验证(无需额外操作)。使用手机号注册的用户,后续可通过 绑定邮箱 + 验证邮箱
完成邮箱验证。
请求体
{
"email": "user@example.com",
"password": "aBc12345",
"nickname": "绿植爱好者",
"verificationCode": "123456"
}
nickname 为可选字段,不传则自动生成 floriax_ + 数字(0–99999)格式的昵称(如 floriax_23456)。
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
email |
string |
条件 | 合法邮箱格式 | 与 phoneNumber 二选一 |
phoneNumber |
string |
条件 | 1[3-9] 开头的 11 位数字 | 与 email 二选一 |
password |
string |
是 | 6-64 字符 | 登录密码 |
nickname |
string |
否 | 最大 24 字符 | 用户昵称,不传则自动随机生成 |
verificationCode |
string |
是 | — | 邮箱/手机收到的验证码 |
响应
{
"code": 200,
"message": "success",
"data": {
"tokenType": "Bearer",
"accessToken": "eyJhbGciOiJSUzI1NiJ9...",
"refreshToken": "dGhpcyBpcyBhIHJlZnJl..."
},
"requestId": "...",
"timestamp": 1747123456789
}
| 字段 | 类型 | 说明 |
|---|---|---|
tokenType |
string |
令牌类型,固定为 Bearer |
accessToken |
string |
JWT 访问令牌 |
refreshToken |
string |
刷新令牌 |