开始 Passkey 登录

POST

/api/user/passkey/login/begin

开始Passkey登录

🔓 无需鉴权

本地契约说明

路由：POST /api/user/passkey/login/begin

注册处理器：github.com/QuantumNous/new-api/controller.PasskeyLoginBegin。

消费方：web_vue。

鉴权：匿名。路由未挂 UserAuth；仍受限流、Turnstile、一次性 flow token 或服务端业务校验约束。

字段状态：controller-confirmed-webauthn-dynamic。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。

页面/功能：登录页启动 discoverable Passkey 登录。

前端传参：无 JSON body。读取 options 后原样传给 navigator.credentials.get；不要在前端构造 credential、修改 challenge 或持久化 flow_token。

前端展示：仅临时保存 WebAuthn options、flow_token 和 expires_at，随后调用 finish。

调试：使用本操作的 x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。

请求参数

Body 参数application/json

示例

{
    "<协议字段>": "<按当前 Controller 或 Provider 文档填写；此处不伪造字段>"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://api-dev.opensosen.cn/api/user/passkey/login/begin' \
--header 'Content-Type: application/json' \
--data '{
    "<协议字段>": "<按当前 Controller 或 Provider 文档填写；此处不伪造字段>"
}'

返回响应

🟢200

application/json

管理端业务响应。HTTP 200 不代表业务成功，必须检查 success。

Bodyapplication/json

示例

成功业务失败仍可能使用 HTTP 200

{
    "success": true,
    "message": "",
    "data": {
        "options": {
            "<WebAuthn-request-option>": "<dynamic>"
        },
        "flow_token": "<redacted-passkey-login-flow>",
        "expires_at": 1786650300
    }
}

🟠429

修改于 2026-08-14 17:19:51

完成密码登录的 2FA 验证

完成 Passkey 登录

开始 Passkey 登录

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明