认证接口

用户注册、登录、个人信息等接口。

用户注册

请求

POST /api/auth/register
Content-Type: application/json

参数

参数类型必填说明
usernamestring是用户名，3-20字符
emailstring是邮箱
passwordstring是密码，至少6位

示例

{
    "username": "user123",
    "email": "user@example.com",
    "password": "password123"
}

响应

{
    "code": 0,
    "message": "注册成功",
    "data": {
        "user": {
            "id": 1,
            "username": "user123",
            "email": "user@example.com",
            "nickname": "user123",
            "avatar": "",
            "create_time": "2025-01-18 10:00:00"
        },
        "token": "eyJhbGciOiJIUzI1NiIs..."
    }
}

用户登录

请求

POST /api/auth/login
Content-Type: application/json

参数

参数类型必填说明
usernamestring是用户名或邮箱
passwordstring是密码

示例

{
    "username": "user123",
    "password": "password123"
}

响应

{
    "code": 0,
    "message": "登录成功",
    "data": {
        "user": {
            "id": 1,
            "username": "user123",
            "email": "user@example.com",
            "nickname": "用户昵称",
            "avatar": "/storage/avatars/1.jpg"
        },
        "token": "eyJhbGciOiJIUzI1NiIs...",
        "expires_in": 604800
    }
}

退出登录

请求

POST /api/auth/logout
Authorization: Bearer {token}

响应

{
    "code": 0,
    "message": "退出成功"
}

获取当前用户

请求

GET /api/auth/user
Authorization: Bearer {token}

响应

{
    "code": 0,
    "data": {
        "id": 1,
        "username": "user123",
        "email": "user@example.com",
        "nickname": "用户昵称",
        "avatar": "/storage/avatars/1.jpg",
        "bio": "个人简介",
        "gender": 1,
        "birthday": "1990-01-01",
        "mobile": "13800138000",
        "status": 1,
        "is_admin": false,
        "create_time": "2025-01-18 10:00:00",
        "stats": {
            "photos": 50,
            "albums": 5,
            "favorites": 100,
            "likes": 200
        }
    }
}

更新个人资料

请求

PUT /api/auth/profile
Authorization: Bearer {token}
Content-Type: application/json

参数

参数类型必填说明
nicknamestring否昵称
biostring否个人简介
genderint否性别：0未知 1男 2女
birthdaystring否生日
mobilestring否手机号

示例

{
    "nickname": "新昵称",
    "bio": "这是我的简介",
    "gender": 1
}

响应

{
    "code": 0,
    "message": "更新成功",
    "data": {
        "id": 1,
        "nickname": "新昵称",
        "bio": "这是我的简介"
    }
}

修改密码

请求

PUT /api/auth/password
Authorization: Bearer {token}
Content-Type: application/json

参数

参数类型必填说明
old_passwordstring是当前密码
new_passwordstring是新密码

示例

{
    "old_password": "oldpass123",
    "new_password": "newpass456"
}

响应

{
    "code": 0,
    "message": "密码修改成功"
}

上传头像

请求

POST /api/auth/avatar
Authorization: Bearer {token}
Content-Type: multipart/form-data

参数

参数类型必填说明
filefile是头像图片文件

响应

{
    "code": 0,
    "message": "上传成功",
    "data": {
        "avatar": "/storage/avatars/1.jpg"
    }
}

错误码

code说明
10001用户名已存在
10002邮箱已存在
10003用户名或密码错误
10004账号已被禁用
10005旧密码错误
10006Token 无效或已过期