开始 TOTP 首次绑定

POST

/api/v1/auth/totp/setup

otpauth issuer 标签取自已加载 Issuer 的 host，不读取请求 Host 或代理头。
Issuer 门禁即时回读后仍不可用时返回 503 issuer_not_configured 或
issuer_runtime_invalid，不会生成来源不明的二维码标签。

请求参数

Body 参数application/json必填

示例

{
    "login_ticket": "string"
}

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/totp/setup' \
--header 'Content-Type: application/json' \
--data '{
    "login_ticket": "string"
}'

🟢200成功

application/json

返回一次性 TOTP 秘钥和标准 otpauth URI

Bodyapplication/json

示例

{
    "secret_base32": "string",
    "otpauth_url": "http://example.com"
}

🟠400请求有误

🟠413

🟠415

🟠422参数错误

🔴503服务器故障

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