Recuperar una Validación de Vivacidad de Documento

Endpoint

GET https://api.verifik.co/v2/document-liveness/{id}

Este servicio recupera un registro específico de vivacidad de documento usando su identificador único. La respuesta incluye los detalles de las verificaciones anti-fraude, estado y metadatos asociados.

Encabezados

Content-Type

Tipo: String
Requerido: Sí

application/json

Authorization

Tipo: String
Requerido: Sí

Bearer <token>

Parámetros de Ruta

id

Tipo: string
Requerido: Sí

ID del registro de Vivacidad de Documento del cual deseas recuperar la información.

Solicitud

Node.js

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/document-liveness/document_liveness_123456789',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_token>'
}

conn.request("GET", "/v2/document-liveness/document_liveness_123456789", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/document-liveness/document_liveness_123456789', [
  'headers' => [
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer <your_token>',
  ]
]);

echo $response->getBody();

Go

package main

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

func main() {
  url := "https://api.verifik.co/v2/document-liveness/document_liveness_123456789"

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

  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer <your_token>")

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

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

  fmt.Println(string(body))
}

Respuesta

200

{
  "success": true,
  "data": {
    "_id": "document_liveness_123456789",
    "client": "client_123456789",
    "appRegistration": "app_registration_123456789",
    "imageSaved": true,
    "imageUrl": "https://cdn.verifik.co/images/document_123456789.jpg",
    "status": "completed",
    "validationResults": {
      "screenReplay": {
        "passed": true,
        "score": 0.95,
        "details": "No screen replay detected"
      },
      "printedCopy": {
        "passed": true,
        "score": 0.90,
        "details": "No printed copy detected"
      },
      "portraitSubstitution": {
        "passed": true,
        "score": 0.88,
        "details": "No portrait substitution detected"
      },
      "digitalManipulation": {
        "passed": true,
        "score": 0.92,
        "details": "No digital manipulation detected"
      }
    },
    "calibrationSettings": {
      "screenReplayCalibration": "REGULAR",
      "printedCopyCalibration": "REGULAR",
      "portraitSubstitutionCalibration": "REGULAR"
    },
    "validationFlags": {
      "ignoreDocumentCroppedValidation": false,
      "ignoreColourLessValidation": false
    },
    "riskScore": 0.05,
    "confidence": 0.91,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:32:00Z",
    "completedAt": "2024-01-15T10:32:00Z"
  },
  "signature": {
    "dateTime": "April 11, 2023 12:25 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "error": "Document liveness not found",
  "message": "DOCUMENT_LIVENESS_NOT_FOUND"
}

Características

• Recuperación por ID: Obtén una validación específica usando su ID único
• Resultados detallados: Información completa de todas las validaciones anti-fraude
• Configuración de calibración: Niveles SOFT, REGULAR y HARD utilizados
• Banderas de validación: Configuraciones para ignorar recorte y falta de color
• Puntajes de confianza: Puntuaciones detalladas por cada tipo de validación
• Almacenamiento de imagen: Información sobre imágenes guardadas en el CDN
• Datos del cliente: Información de cliente y registro de aplicación
• Múltiples lenguajes: Soporte para JavaScript, Python, PHP y Go
• Manejo de errores: Respuestas de error detalladas para distintos escenarios