注册

接口说明

提交用户名、密码、手机号等信息完成账号注册。注册成功后，接口直接返回访问令牌，调用方可无需再次登录即可访问受保护资源。

请求信息

项目	值
Method	POST
URL	/api/auth/register
鉴权	否

请求参数

参数名	类型	必填	说明
username	string	是	登录用户名，3-50 字符
password	string	是	登录密码，8-20 字符
name	string	否	显示名称，最长 50 字符
phone	string	是	手机号，1[3-9] 开头，共 11 位
email	string	否	邮箱地址，最长 100 字符

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "zhangsan",
    "password": "Pass@1234",
    "name": "张三",
    "phone": "13800138000",
    "email": "zhangsan@example.com"
  }'

响应参数

字段	类型	说明
code	int	0=成功
message	string	提示信息
data.access_token	string	访问令牌
data.token_type	string	令牌类型，固定值 “Bearer”
data.expires_in	int	令牌有效期（秒）
data.user.id	int	用户 ID
data.user.username	string	登录用户名
data.user.name	string	显示名称
data.user.avatar	string|null	头像地址，可为空
data.user.user_type	int	用户类型编码
data.user.user_type_label	string	用户类型名称
data.user.department	object|null	所属部门（含 id、name），无则为 null
data.user.position	string|null	职位，可为空
data.user.roles	array	角色标识字符串数组
data.user.permissions	array	权限标识字符串数组

成功响应

{
  "code": 0,
  "message": "注册成功",
  "data": {
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "user": {
      "id": 101,
      "username": "zhangsan",
      "name": "张三",
      "avatar": null,
      "user_type": 1,
      "user_type_label": "普通用户",
      "department": { "id": 5, "name": "研发部" },
      "position": null,
      "roles": ["user"],
      "permissions": ["profile:read", "profile:update"]
    }
  }
}

失败响应

{ "code": 10003, "message": "用户名已存在", "data": null }

{ "code": 20002, "message": "手机号已存在", "data": null }

{ "code": 422, "message": "参数校验失败", "data": null }