使用 TOTP 完成待处理登录

POST

/api/v1/auth/totp/login

错误码：

401 invalid_factor：验证码错误或已被限流。

503 factor_key_unavailable：已注册的 TOTP 种子由已退役的加密 kid 保护，
服务端无法解密。用户重试无效，必须由管理员调用
DELETE /api/v1/admin/users/{user_id}/auth-factors/totp 重置因子后重新绑定。
该结果不消耗认证失败额度，也不会把账号推向限流。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "login_ticket": "string",
    "code": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/totp/login' \
--header 'X-Chenxing-Session-Mode;' \
--header 'Content-Type: application/json' \
--data '{
    "login_ticket": "string",
    "code": "string"
}'

返回响应

🟢200成功

application/json

TOTP 正确，已设置 Session 和 CSRF Cookie

Headers

Bodyapplication/json

示例

{
    "session_id": "string",
    "expires_at": "2019-08-24T14:15:22.123Z"
}

🟠400请求有误

🟠401没有权限

🟠413服务器故障

🟠415

🟠422参数错误

🔴503服务器故障

修改于 2026-10-01 05:59:34

确认 TOTP 并完成登录

开始 passkey 注册