使用当前 Session 开始 TOTP 注册

POST

/api/v1/auth/security/totp/enrollment/start

创建约五分钟有效、绑定当前用户、Session ID 和 session_epoch 的待确认注册。
同一用户同一方法只允许一份 pending；并发败者返回 409，绝不覆盖已返回的种子。
otpauth issuer 标签取自配置 Issuer 的 host，不读取请求 Host 或代理头。

请求参数

Header 参数

Body 参数application/json必填

示例

{}

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/security/totp/enrollment/start' \
--header 'X-CSRF-Token;' \
--header 'Content-Type: application/json' \
--data '{}'

🟢200成功

application/json

待确认 TOTP 注册

Bodyapplication/json

示例

{
    "enrollment_id": "cd8e6b59-f5cf-4894-8850-4dc2dc1aaf8e",
    "secret_base32": "string",
    "otpauth_url": "http://example.com"
}

🟠400请求有误

🟠401没有权限

🟠409

🟠413

🟠415

🟠422参数错误

🔴503服务器故障

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