Listar Todas las Validaciones Biométricas

Endpoint

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

Recupera una lista de registros de validaciones biométricas basada en filtros y parámetros especificados.

Encabezados

Authorization

Tipo: String
Requerido: Sí

Bearer {YOUR_ACCESS_TOKEN}

Parámetros de Consulta

page

Tipo: Number
Requerido: No

Número de página (comienza en 1).

Ejemplo: page=1

perPage

Tipo: Number
Requerido: No

Elementos por página (por defecto: 20).

Ejemplo: perPage=10

offset

Tipo: Number
Requerido: No

Alternativa a page para omitir registros.

Ejemplo: offset=20

populates[]

Tipo: Array
Requerido: No

Campos a rellenar con datos relacionados.

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

where_client

Tipo: String
Requerido: No

Filtrar por ID de cliente.

Ejemplo: where_client=507f1f77bcf86cd799439013

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

in_status

Tipo: Array
Requerido: No

Filtrar por múltiples estados.

Ejemplo: in_status[]=validated&in_status[]=failed

where>_createdAt

Tipo: String
Requerido: No

Filtrar registros creados después de la fecha.

Ejemplo: where>_createdAt=2024-12-01

sort

Tipo: String
Requerido: No

Orden de clasificación (prefijo con - para descendente).

Ejemplo: sort=-createdAt

Solicitud

Node.js

const axios = require("axios");

const config = {
  method: "get",
  url: "https://api.verifik.co/v2/biometric-validations",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  },
  params: {
    page: 1,
    perPage: 10,
    "populates[]": ["client", "project"],
    where_status: "validated",
    where_type: "login",
    sort: "-createdAt"
  }
};

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"

params = {
  'page': 1,
  'perPage': 10,
  'populates[]': ['client', 'project'],
  'where_status': 'validated',
  'where_type': 'login',
  'sort': '-createdAt'
}

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?page=1&perPage=10&populates[]=client&populates[]=project&where_status=validated&where_type=login&sort=-createdAt',
  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?page=1&perPage=10&populates[]=client&populates[]=project&where_status=validated&where_type=login&sort=-createdAt"

  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"
      },
      "status": "completed",
      "identifier": "user@example.com",
      "type": "login",
      "expiresAt": "2024-01-15T11:30:00Z",
      "requires2FA": false,
      "ipAddress": "192.168.1.1",
      "biometricData": {
        "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"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 10,
    "total": 1,
    "pages": 1
  }
}

Respuestas de Error

{
  "success": false,
  "error": "Parámetros de consulta inválidos",
  "code": "INVALID_PARAMETERS"
}