Skip to main content

​
概述

用户登录接口用于获取访问令牌（access token），该令牌用于后续API调用的身份验证。

​
认证方式

该接口不需要预先的认证信息，使用用户名和密码进行登录。

​
请求参数

​
请求体

​
username
string
required
用户的用户名
​
password
string
required
用户的密码

​
响应说明

​
成功响应

登录成功后，系统会返回访问令牌和用户信息。

​
响应字段说明

​
使用示例

​
用户登录

curl -X POST 'https://your-domain.com/api/v1/login' \\
  -H 'Content-Type: application/json' \\
  -d '{
    "username": "your_username",
    "password": "your_password"
  }'

​
响应示例

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 3600,
  "user": {
    "id": "user_123456",
    "username": "example_user",
    "role": "user",
    "status": "active",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-15T12:00:00Z",
    "last_login": "2024-01-15T12:00:00Z",
    "api_calls_count": 150,
    "max_api_calls": 1000
  }
}

​
使用令牌

登录成功后，您需要在后续API请求的Header中包含访问令牌： 
-H 'Authorization: Bearer your_access_token'

​
安全建议

  1. 令牌存储：安全存储访问令牌，避免泄露
  2. 令牌刷新：在令牌过期前重新登录获取新令牌
  3. 密码安全：使用强密码并定期更换
  4. HTTPS：始终通过HTTPS协议进行登录请求
  5. 错误处理：妥善处理登录失败的情况