Recuperar una Validación Biométrica

Endpoint

GET https://api.verifik.co/v2/biometric-validations/{id}

Una Validación Biométrica es una instancia dentro del sistema de Verifik que te permite procesar y validar identidades de usuarios a través de reconocimiento facial y detección de vida. Este endpoint recupera un registro de validación biométrica específico por su identificador único, incluyendo todos los datos y relaciones asociados.

Encabezados

Authorization

Tipo: String
Requerido: Sí

Bearer {YOUR_ACCESS_TOKEN}

Parámetros de Ruta

id

Tipo: String
Requerido: Sí

Identificador único de la validación biométrica a recuperar.

Parámetros de Consulta

populates[]

Tipo: Array
Requerido: No

Campos a rellenar con datos relacionados.

Ejemplo: populates[]=client&populates[]=project

sort

Tipo: String
Requerido: No

Orden de clasificación para resultados. Prefijo con - para descendente.

Ejemplo: sort=-createdAt

limit

Tipo: Number
Requerido: No

Número máximo de resultados a devolver.

Ejemplo: limit=10

where_client

Tipo: String
Requerido: No

Filtrar por ID de cliente.

Ejemplo: where_client=507f1f77bcf86cd799439013

where_project

Tipo: String
Requerido: No

Filtrar por ID de proyecto.

Ejemplo: where_project=507f1f77bcf86cd799439011

where_projectFlow

Tipo: String
Requerido: No

Filtrar por ID de flujo de proyecto.

Ejemplo: where_projectFlow=507f1f77bcf86cd799439015

where_status

Tipo: String
Requerido: No

Filtrar por estado de validación.

Ejemplo: where_status=validated

where_type

Tipo: String
Requerido: No

Filtrar por tipo de validación.

Ejemplo: where_type=login

where_livenessSession

Tipo: String
Requerido: No

Filtrar por ID de sesión de vida.

Ejemplo: where_livenessSession=674de8df21c72be3cc42b8a7

Solicitud

Node.js

const axios = require("axios");

const config = {
  method: "get",
  url: "https://api.verifik.co/v2/biometric-validations/biometric_validation_123456789",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  },
  params: {
    "populates[]": ["client", "project", "projectFlow"],
    "sort": "-createdAt",
    "limit": 10
  }
};

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

Python

import requests

url = "https://api.verifik.co/v2/biometric-validations/biometric_validation_123456789"

params = {
  'populates[]': ['client', 'project', 'projectFlow'],
  'sort': '-createdAt',
  'limit': 10
}

headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}

response = requests.request("GET", url, headers=headers, params=params)

print(response.text)

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.verifik.co/v2/biometric-validations/biometric_validation_123456789?populates[]=client&populates[]=project&populates[]=projectFlow&sort=-createdAt&limit=10',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.verifik.co/v2/biometric-validations/biometric_validation_123456789?populates[]=client&populates[]=project&populates[]=projectFlow&sort=-createdAt&limit=10"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}

Respuesta

{
  "success": true,
  "data": {
    "_id": "biometric_validation_123456789",
    "client": {
      "_id": "client_123456789",
      "name": "Cliente de Ejemplo",
      "email": "client@example.com"
    },
    "project": {
      "_id": "project_123456789",
      "name": "Proyecto de Ejemplo",
      "description": "Descripción del proyecto de ejemplo"
    },
    "projectFlow": {
      "_id": "flow_123456789",
      "name": "Flujo de Ejemplo",
      "type": "onboarding"
    },
    "livenessSession": "liveness_123456789",
    "appRegistration": "reg_123456789",
    "status": "completed",
    "identifier": "user@example.com",
    "type": "validation",
    "expiresAt": "2024-01-15T11:30:00Z",
    "redirectUrl": "https://example.com/success",
    "webhookUrl": "https://example.com/webhook",
    "requires2FA": false,
    "ipAddress": "192.168.1.1",
    "sendViaEmail": true,
    "email": "user@example.com",
    "language": "en",
    "biometricData": {
      "faceImage": "base64_encoded_image",
      "template": "biometric_template_data",
      "quality": "good",
      "livenessScore": 0.95
    },
    "verificationResults": {
      "livenessDetection": "passed",
      "identityMatch": "passed",
      "qualityScore": 0.95,
      "antiSpoofing": "passed"
    },
    "riskScore": 0.05,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:32:00Z",
    "completedAt": "2024-01-15T10:32:00Z"
  }
}

Respuestas de Error

{
  "success": false,
  "error": "Validación biométrica no encontrada",
  "code": "BIOMETRIC_VALIDATION_NOT_FOUND"
}