登录账号

POST

/api/login

用户模块

最后修改时间：2025-01-25 12:29:57

责任人：未设置

请求体中包含以下字段：

username: 用户名

password: 密码

可能要包含的字段：

grant_type: 设置为password

须以表单形式提交。

请求参数

Body 参数application/x-www-form-urlencoded

grant_type

Grant Type

可选

Any of

string

null

示例值:

password

正则匹配:

password

username

string

Username

必需

示例值:

admin

password

string

Password

必需

示例值:

admin

scope

string

Scope

可选

默认值:

client_id

Client Id

可选

Any of

string

null

client_secret

Client Secret

可选

Any of

string

null

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/login' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'username=admin' \
--data-urlencode 'password=admin' \
--data-urlencode 'scope=' \
--data-urlencode 'client_id=' \
--data-urlencode 'client_secret='

返回响应

🟢200登录成功返回access_token和refresh_token

application/json

Body

access_token

string

Access Token

必需

refresh_token

string

Refresh Token

必需

token_type

string

Token Type

必需

username

string

Username

必需

示例

{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
    "token_type": "bearer",
    "username": "admin"
}

🟠401账号或密码错误

🟠422Validation Error

修改于 2025-01-25 12:29:57

注册一个管理员账户

当access_token过期时，用refresh_token获取新的access_token