Validate Biometric Validation (Validar la Validación Biométrica)

Endpoint

https://api.verifik.co/v2/biometric-validations/validate

Este endpoint se utiliza para validar una sesión biométrica basada en los resultados de liveness o en datos de imagen. La validación verifica si los datos biométricos proporcionados (como una imagen) corresponden a la sesión activa.

Headers

Parameter
Type
Description

Authentication

string

Parameters

Parameter
Type
Description
Required

image

string

Base64 encoded image data used for biometric validation.

Yes

os

string

The operating system of the client device (e.g., "ios", "android").

Yes

Request

curl --location --request POST 'https://api.verifik.co/v2/biometric-validations/validate' \
--header 'Authorization: Bearer <JWT token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "os": "ios"
}'

Response

{
    "data": {
        "appLogin": {
            "_id": "66e3338e90c120bf345a1dcc",
            "client": "613375a1eab2fe08527f81e2",
            "name": "Carlos Bleck",
            "status": "validated",
            "project": "6266193db77ccc8111730c90",
            "projectFlow": "658ed28b0990f300134d7b78",
            "type": "faceLiveness",
            "biometricValidation": "66e3338e90c120bf345a1dca",
            "updatedAt": "2024-09-12T18:32:17.224Z",
            "createdAt": "2024-09-12T18:31:42.723Z",
            "__v": 0,
            "face": "66e333b090c120bf345a1ddf"
        },
        "livenessSession": {
            "_id": "66e3338e90c120bf345a1dc8",
            "client": "613375a1eab2fe08527f81e2",
            "project": "6266193db77ccc8111730c90",
            "projectFlow": "658ed28b0990f300134d7b78",
            "identifier": "03da12fba",
            "status": "active",
            "livenessResult": [],
            "comparisonResult": [],
            "generalInformation": [],
            "documentTypeFields": [],
            "location": [],
            "proFields": [],
            "studioFields": [],
            "promptFields": [],
            "expiresAt": "2024-09-12T18:35:42.000Z",
            "activatedAt": "2024-09-12T18:31:42.524Z",
            "updatedAt": "2024-09-12T18:31:42.526Z",
            "createdAt": "2024-09-12T18:31:42.526Z",
            "__v": 0
        },
        "person": "6633eabb0ced0451db577393",
        "token": "eyJhbGciOiJIUCI6IkpXVCJ9.eyJpZ...CI6wIZLtiM8"
    },
    "signature": {
        "dateTime": "September 12, 2024 6:32 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "K5B3J"
}

Detalles de la Respuesta

data.appLogin: Detalles sobre la sesión de inicio de sesión creada para la aplicación:

  • _id: El identificador único de la sesión de inicio de sesión.

  • client: El identificador único del cliente.

  • name: El nombre de la persona validada.

  • status: El estado actual de la sesión (por ejemplo, "validated").

  • project: El ID del proyecto asociado con esta validación.

  • projectFlow: El ID del flujo del proyecto.

  • type: El tipo de validación biométrica (por ejemplo, "faceLiveness").

  • biometricValidation: El ID de la validación biométrica utilizada.

  • updatedAt: La marca de tiempo de la última actualización de la sesión.

  • createdAt: La marca de tiempo de la creación de la sesión.

  • face: El ID de la validación facial asociada con esta sesión.

data.livenessSession: Detalles sobre la sesión de liveness utilizada para la validación:

  • _id: El identificador único de la sesión de liveness.

  • client: El identificador único del cliente.

  • project: El ID del proyecto asociado con la sesión.

  • identifier: El identificador de la sesión.

  • status: El estado de la sesión (por ejemplo, "active").

  • livenessResult: Resultados de la verificación de liveness (array).

  • expiresAt: La marca de tiempo de expiración de la sesión.

  • createdAt: La marca de tiempo de la creación de la sesión.

  • updatedAt: La marca de tiempo de la última actualización de la sesión.

  • data.person: El ID de la persona involucrada en la validación biométrica.

data.token: Un token JWT asociado con la sesión.

signature: Una firma que confirma que la validación biométrica fue certificada por Verifik.

  • dateTime: La fecha y hora en que la validación fue certificada.

  • message: El mensaje de certificación.

Last updated