APapiqik
AccountService

POST /v1/account/login

Changed on

Login 账号登录，成功返回 access_token + refresh_token；若开启 2FA 返回 two_fa_required=true

Request

Request body

accountTypeinteger

邮箱对应多个账号类型时必填；0 表示由服务端在当前入口允许的类型内定位。

passwordstring

密码

portalstring

Login portal: console=user console, admin=admin console; empty defaults to console.

rememberMeboolean

是否请求长期有效会话；具体有效期由后台 auth.session.remember_me_ttl_hours 控制。

usernamestring

登录标识符：支持用户名、邮箱或手机号

  • 用户名：字母、数字、下划线、中划线组合
  • 邮箱：标准邮箱格式（如 user@example.com）
  • 手机号：中国大陆 11 位手机号（如 13800138000）

Response

OK

twoFaRequiredboolean

是否需要二步验证（true 时 auth 为空）

twoFaTokenstring

临时 token，用于后续 Verify2FA（two_fa_required=true 时有效）

Changes