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	The JWT token you got from the Creation of the Biometric Validation

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

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"
}'

Node.js

const axios = require('axios');

let data = JSON.stringify({
  "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "os": "ios"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.verifik.co/v2/biometric-validations/validate',
  headers: {
    'Authorization': 'Bearer <JWT token>',
    'Content-Type': 'application/json'
  },
  data: data
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

Response

200

{
    "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"
}

401

{
    "code": "InvalidCredentials",
    "message": "caused by JsonWebTokenError: invalid signature"
}

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.