使用当前 Session 开始 Passkey 注册

POST

/api/v1/auth/security/passkeys/registration/start

创建绑定当前用户、Session ID 和 session_epoch 的 WebAuthn challenge。
已有 TOTP 或其他 Passkey 不阻止新增凭据；同一用户同一方法的并发 start 不覆盖 challenge。

请求参数

Header 参数

Body 参数application/json必填

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200成功

application/json

Passkey 注册 challenge

Bodyapplication/json

示例

{
    "enrollment_id": "cd8e6b59-f5cf-4894-8850-4dc2dc1aaf8e",
    "options": {
        "property1": "string",
        "property2": "string"
    }
}

🟠400请求有误

🟠401没有权限

🟠409

🟠413

🟠415

🟠422参数错误

修改于 2026-08-16 10:45:15

确认当前 Session 的 TOTP 注册

完成当前 Session 的 Passkey 注册