完成 Passkey 登录

完成Passkey登录

🔓 无需鉴权。签发新登录 Session 时可能返回 409 AUTH_SESSION_LIMIT 或 429 AUTH_SESSION_ISSUANCE_LIMIT。

本地契约说明

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

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

消费方：web_vue。

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

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

页面/功能：登录页把浏览器的 Passkey 断言提交给后端，建立 Dashboard 会话。

前端传参：必传 begin 返回的 flow_token 和 navigator.credentials.get 的序列化 credential。credential 是标准 WebAuthn 动态对象，必须原样传递，不可记录或持久化。

前端展示：成功后更新内存 access token、会话和用户资料；refresh Cookie 仅由浏览器接收。

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

请求参数

Body 参数application/json必填

示例

{
    "flow_token": "<redacted-passkey-login-flow>",
    "credential": {
        "id": "<redacted-credential-id>",
        "rawId": "<redacted-raw-id>",
        "type": "public-key",
        "response": {},
        "clientExtensionResults": {}
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

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

{
    "success": true,
    "message": "",
    "data": {
        "access_token": "<redacted-access-token>",
        "token_type": "Bearer",
        "access_expires_at": 1786650900,
        "session": {
            "sid": "00000000-0000-0000-0000-000000000001",
            "current": true,
            "login_method": "passkey",
            "ip": "127.0.0.1",
            "user_agent": "debug-browser",
            "created_at": 1786650000,
            "last_active_at": 1786650000,
            "expires_at": 1789242000
        },
        "user": {
            "id": 1,
            "username": "debug-user",
            "display_name": "Debug User",
            "role": 1,
            "status": 1,
            "email": "d***@example.test",
            "group": "default",
            "quota": 0,
            "used_quota": 0,
            "request_count": 0,
            "permissions": {
                "sidebar_settings": true,
                "sidebar_modules": {},
                "admin_permissions": {}
            }
        }
    }
}

🟠409

🟠429

完成 Passkey 登录

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明