认证 API
用户身份验证和授权相关的API接口文档
API 概述
认证API提供用户注册、登录、令牌管理和权限验证等功能。 所有API都使用JWT令牌进行身份验证。
用户认证
注册、登录和密码管理
令牌管理
JWT令牌生成和验证
权限控制
角色和权限验证
用户注册
POST /api/auth/register
创建新用户账户
POST https://api.linuxcloudlab.com/auth/register
Content-Type: application/json
{
"username": "john_doe",
"email": "[email protected]",
"password": "SecurePass123!",
"firstName": "John",
"lastName": "Doe"
}
响应示例
{
"success": true,
"message": "用户注册成功",
"data": {
"userId": "user_123456",
"username": "john_doe",
"email": "[email protected]"
}
}
用户登录
POST /api/auth/login
用户身份验证并获取访问令牌
POST https://api.linuxcloudlab.com/auth/login
Content-Type: application/json
{
"email": "[email protected]",
"password": "SecurePass123!"
}
响应示例
{
"success": true,
"message": "登录成功",
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiIs...",
"refreshToken": "eyJhbGciOiJIUzI1NiIs...",
"expiresIn": 3600,
"user": {
"id": "user_123456",
"username": "john_doe",
"email": "[email protected]",
"role": "student"
}
}
}
令牌管理
POST /api/auth/refresh
刷新访问令牌
POST https://api.linuxcloudlab.com/auth/refresh
Content-Type: application/json
{
"refreshToken": "eyJhbGciOiJIUzI1NiIs..."
}
GET /api/auth/verify
验证访问令牌
GET https://api.linuxcloudlab.com/auth/verify
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
POST /api/auth/logout
用户登出并撤销令牌
POST https://api.linuxcloudlab.com/auth/logout
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
密码管理
POST /api/auth/forgot-password
发送密码重置邮件
POST https://api.linuxcloudlab.com/auth/forgot-password
Content-Type: application/json
{
"email": "[email protected]"
}
POST /api/auth/reset-password
重置用户密码
POST https://api.linuxcloudlab.com/auth/reset-password
Content-Type: application/json
{
"token": "reset_token_here",
"newPassword": "NewSecurePass123!"
}
错误代码
成功响应
- 200 - 请求成功
- 201 - 创建成功
错误响应
- 400 - 请求参数错误
- 401 - 未授权访问
- 403 - 权限不足
- 409 - 用户已存在