认证

登录

POST/api/auth/login

使用用户名和密码认证用户。启用双因素身份验证的用户会收到短期部分令牌以完成登录。

Request body

Name	Type	Description
passwordrequired	string	Umami password.
usernamerequired	string	Umami username.

Example request

{
  "password": "string",
  "username": "string"
}

Responses

200Authenticated successfully.

Name	Type	Description
anyOf	anyOf

200 example

{
  "partialToken": "string",
  "requiresTwoFactor": true
}

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

503Service unavailable.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

503 example

{
  "error": {
    "code": "service-unavailable",
    "message": "Service unavailable.",
    "status": 503
  }
}

Code samples

cURL

curl -X POST 'https://api.example.com/api/auth/login' \
  -H 'Content-Type: application/json' \
  -d '{
  "password": "string",
  "username": "string"
}'

Previous获取订阅详情 Next退出登录

On this page