Verify Complete #

verifyComplete

How to complete a verify function using a Passkey #

The verifyComplete function finalizes the verify process after the passkey has been successfully verified on the user’s device. This involves sending the FIDO2 attestation credentials to the AppKey server to confirm the verify.

Typically, the client-side SDK will automatically populate the necessary REST API parameters, ensuring that the correct data is sent to the server.

URL #

    /api/appuser/verifyComplete

Method #

    POST

Headers #

	app-token: "<App Token>"

Data Parameter #

    {
        handle: <user handle>,
        id: <assertion id>,
        response: {
            authenticatorData: <authenticator data>,
            clientDataJSON: <client data JSON object>,
            signature: <assertion signature>,
            userHandle: <user handle>
        }
    }

Response: #

Success: #

StatusCode: #

    200 (OK)

Contents: #

    {
        valid: <true | false>
    }

Error: #

StatusCode: #

    400 (BAD REQUEST)
    500 (INTERNAL SERVER ERROR)

Content: #

    {
        code: "<internal error code>",
        message: "<readable error description>"
    }

The internal codes are integers:

400 - invalid app token
401 - app no longer exists
402 - app is suspended
403 - missing parameter
404 - user account is suspended
413 - app is migrated
500 - internal server error
600 - invalid login credentials
611 - apple account already exist
612 - google account already exist