Verifik
Verifik - ES
Verifik - ES
  • Documentación
  • Cuentas
    • Autenticación
      • Correo de autenticación
      • Teléfono de Autenticación
      • Renovar tu Token (JWT)
      • Crear un Nuevo Token y Revocar Tokens Anteriores
  • Services
    • Revisión Inteligente
      • Ejemplo de consulta en la aplicación
    • Acceso Inteligente
      • Panel de control
    • Acceso
      • Ejemplo de acceso por correo eletrónico
      • Ejemplo acceso telefónico
      • Ejemplo de acceso biométrico
    • Registro Inteligente
    • Registro
      • Tutorial
    • Escaneo Inteligente
  • Biometrics API's
    • Pueba de Vida
      • Detección de vida
    • Comparar
      • Detección de vida y Comparar
      • Comparar 1:1
    • Busqueda
      • Buscar 1:N | Live (Vida)
      • Busqueda 1:N
      • Buscar 1:N | Crop (recortar)
      • Face Detect (Detección de rostro)
      • Face Verify (Verificacion de rostro)
  • Scan Docs API's
    • Estudio de Escaneo
      • Documentos permitidos
      • 🇨🇴Tarjeta de propiedad
    • Solicitud de Escaneo
      • Documentos soportados
    • Plantillas de ScanPrompt
  • Resources
    • Proyectos
      • Objeto del proyecto
      • Crear un proyecto
      • Actualizar un proyecto
      • Ver un proyecto
      • Listar todos los proyectos
    • Flujos de proyecto
      • The ProjectFlow object (Objetos de flujo de proyecto)
      • Create a project flow (Crear un flujo de proyecto)
        • Login settings (Configuración de inicio de sesión)
        • Onboarding settings (Configuración de incorporación)
        • Security settings (Configuración de seguridad)
      • Update a project flow (Subir un flujo de un proyecto)
      • Retrieve a project flow (Recuperar un flujo de un proyecto)
      • List all project flows (Listar todos los flujos de proyecto)
    • Inicios de sesión de app
      • Inicio de sesión en la app
      • Crear inicio de sesión en la app
      • Recuperar inicio de sesión en la app
      • Listar los inicios de sesión en la app
    • Registros en la app
      • Registrar objetos en la app
      • Crear un registro en la app
      • Sincronizar el estado de registro en la app
      • Recuperar un registro en la app
      • Lista de todos los registros en la app
    • Documentos de validación
      • El objeto de Validación de Documentos
      • Crear documento de validación
      • Recuperar una validación de documento
      • Lista de documentos de validación
      • Eliminar un documento de validación
    • Validaciones de correo electrónico
      • El objeto de Validación de Correo Electrónico
      • Crear validación de correo electrónico
      • Validar la validación de correo electrónico
      • Recuperar una validación de correo electrónico
      • Lista de validaciones de correo electrónico
    • Validaciones de teléfono
      • El objeto de validaciones de teléfono
      • Crear Validación de Teléfono
      • Validar la Validación de Teléfono
      • Recuperar una Validación de Teléfono
      • Lista de Validaciones de Teléfono
    • Colecciones
      • El objeto de Colección
      • Crear una Colección
      • Recuperar una Colección
      • Listar todas las Colecciones
    • Personas
      • El objeto de Persona
      • Crear una Persona
      • Crear una Persona con detección de vida
      • Actualizar una persona
      • Suprimir una persona
      • Recuperar una Persona
      • Listar todas las Personas
    • Webhooks
      • El objeto de Webhook
      • Crear un Webhook
      • Actualizar un Webhook
      • Eliminar un Webhook
      • Recuperar un Webhook
      • Listar todos los Webhooks
      • Integración de Webhook
    • Validaciones Biométricas
      • El objeto de Validación Biométrica
      • Crear Validación Biométrica
      • Validar la Validación Biométrica
      • Recuperar una Validación Biométrica
      • Listar todas las Validaciones Biométricas
  • Planes y Precios
    • Planes de Evaluación de Base de Datos
    • Planes de Smart Access
      • Plan Gratuito
      • Usuarios Activos
      • Sesiones
      • Cargos extras
      • Planes Empresariales
    • Planes de SmartEnroll
    • Enroll Plans (Planes de Registro)
    • Precios de SMS/WhatsApp
  • Validaciones de identidad
    • 🇦🇷Argentina
    • 🇧🇴Bolivia
    • 🇧🇷Brasil
    • 🇨🇦Canada
      • 🇨🇦Licencia de Conducir de Ontario
      • 🇨🇦Licencia de Conducir de Quebec
      • 🇨🇦Licencia de Conducir de Columbia Británica
    • 🇨🇱Chile
      • 🇨🇱Información del Contribuyente Chileno
    • 🇨🇴Colombia
      • 🇨🇴Ciudadano Colombiano
      • 🇨🇴Ciudadano Colombiano con Datos Adicionales
      • 🇨🇴Personas Expuestas Políticamente en Colombia
      • 🇨🇴Permiso Especial de Permanencia (PEP) - Documento de Identificación
      • 🇨🇴Cédula de Extranjería Colombiana (CE)
    • 🇨🇷Costa Rica
    • 🇩🇴Republica Dominicana
    • 🇪🇨Ecuador
    • 🇸🇻El Salvador
    • 🇬🇹Guatemala
    • 🇭🇳Honduras
    • 🇲🇽Mexico
    • 🇵🇦Panamá
    • 🇵🇾Paraguay
    • 🇵🇪Perú
      • 🇵🇪Ciudadano Peruano
      • 🇵🇪Residente Extranjero en Perú
      • 🇵🇪Información de Ciudadanos Peruanos con Datos Adicionales
    • 🇪🇸Ciudadano Español
    • 🇺🇸Estados Unidos
      • 🇺🇸Verificación del SSN (Número de Seguridad Social)
      • 🇺🇸Validación de Licencia de Conducir de Florida
      • 🇺🇸Verificación de la licencia de conducir de Kansas
    • 🇺🇾Uruguay
    • 🇻🇪Venezuela
      • 🇻🇪Información del ciudadano Venezolano
      • 🇻🇪Ciudadanos extranjeros en Venezuela
  • Vehicle Validation
    • 🇦🇷Argentina
    • 🇧🇴Bolivia
    • 🇧🇷Brasil
    • 🇨🇱Chile
      • 🇨🇱Información del vehículo
      • 🇨🇱Licencia de conducir
    • 🇨🇴Colombia
      • 🇨🇴Vehículo por código - Fasecolda
      • 🇨🇴Resoluciones del SIMIT
      • 🇨🇴Informacion de vehiculo por Numero de VIN - RUNT
      • 🇨🇴Sistema de Información para Conductores que Transportan Mercancías Peligrosas
      • 🇨🇴SOAT y RTM del vehículo por placa y documento de identidad
      • 🇨🇴General query of SIMIT by license plate
      • 🇨🇴Driver's License
      • 🇨🇴Vehicle by plate and identification card only
      • 🇨🇴Vehicle Values by Plate - Fasecolda
      • 🇨🇴Verifik Pico y Placa for Bogotá
      • 🇨🇴Complete vehicle with historical records by plate and identification document - RUNT
      • 🇨🇴SIMIT Agreements
      • 🇨🇴SIMIT Fines
      • 🇨🇴General query of SIMIT by Identification Document
      • 🇨🇴Sinister Verification - Fasecolda
      • 🇨🇴Vehicle Fines Check in Bogotá, Colombia
      • 🇨🇴Taxes in Bogota
      • 🇨🇴Vehicle accidentality in Bogota
    • 🇨🇷Costa Rica
    • 🇪🇨Ecuador
      • 🇪🇨Ecuador Vehicle Fines
      • 🇪🇨Vehicle Information Lookup
    • 🇲🇽Mexico
    • 🇵🇾Paraguay
    • 🇵🇪Peru
      • 🇵🇪Peruvian Vehicle
      • 🇵🇪Peruvian Vehicle Insurance
    • 🇺🇸United States
      • 🇺🇸Vehicle Information
      • 🇺🇸Vehicle Information by VIN
  • Business Validation
    • 🇦🇷Argentina
    • 🇧🇴Bolivia
    • 🇧🇷Brazil
    • 🇨🇦Canada
    • 🇨🇱Chilean
    • 🇨🇴Colombia
      • 🇨🇴Colombian Business Information - RUES
      • 🇨🇴Complete Business Registry - RUES
      • 🇨🇴Colombian Company DIAN Verification
      • 🇨🇴Verify Legal Invoicer in DIAN for Colombian Companies
    • 🇨🇷Costa Rica
    • 🇲🇽Mexico
    • 🇵🇦Panama
    • 🇵🇾Paraguay
    • 🇵🇪Peru
    • 🇪🇸Spain
    • 🇺🇸United States
  • Background Check
    • 🇧🇷Brazil
    • 🇨🇴Colombia
      • 🇨🇴Public Contracts
      • 🇨🇴Colombian Police Record Check
      • 🇨🇴Verify Police Compliance with Corrective Measures
      • 🇨🇴Comptroller Certificate
      • 🇨🇴Disciplinary Records in Colombia (attorney's office)
    • 🌎International
      • 🌎Interpol Background Check
      • 🌎OFAC Background Check
      • 🌎Europol Background Check
      • 🌎FBI Background Check
      • 🌎ONU Background Check
      • 🌎DEA Background Check
  • Military
    • 🇨🇴Colombia
  • Finance
    • 🇨🇴Delinquent debtors
  • Legal
    • 🇨🇴Lawyer Verification
    • 🇨🇴Colombian Legal Processes
    • 🇨🇴Retrieve Details of a Legal Process by Number
    • 🇨🇴Court Case Records Lookup
    • 🇨🇴Certificate of Validity for Legal Professionals
  • Certificates
    • 🇨🇴Registry Certificate
    • 🇨🇴High Altitude Job Eligibility
    • 🇨🇴SENA Certificates
  • Voting
    • 🇨🇴Retrieve Voting Information for Colombian Citizens
  • Health
    • 🇨🇴Colombian RETHUS Verification Data
    • 🇨🇴Verify Colombian Affiliations
  • Verifik LLC
    • Privacy Policy
    • Políticas de Privacidad
    • Términos y Condiciones
    • Terms and Conditions
    • Acuerdo de Niveles de Servicio
    • Service Level Agreement
    • Verifik for Enterprises HUB (Esp)
    • Verifik for Enterprises HUB (Eng)
    • SmartCheck Terms and Conditions of Use
Powered by GitBook
On this page
  • Endpoint
  • Qué Hace Esta API Esta API realiza dos tareas clave:
  • Cómo Funciona
  • Ideal para:
  • Mejores Prácticas
  • Ejemplos
  • Solución de Problemas
  • Lo que necesitas
  • ¿Listo para integrar?
  • Encabezados (Headers)
  • Body
  • Ejemplo de Body
  • Response
  • Estructura de la Respuesta
  1. Biometrics API's
  2. Comparar

Detección de vida y Comparar

API para comparar selfies y realizar una detección de vida en la selfie de 'probe'.

Este servicio te ayuda a comparar una única selfie (llamada "probe") con una colección de selfies (llamada "gallery") para verificar identidades y realizar una detección de vida en la imagen de probe. Es ideal para controlar el acceso a tu aplicación o completar verificaciones de Know Your Customer (KYC) de manera segura.

¡Vamos a desglosarlo paso a paso!

Endpoint

https://api.verifik.co/v2/face-recognition/compare-with-liveness

Qué Hace Esta API Esta API realiza dos tareas clave:

  • Comparación Facial (1 a muchos): Verifica si el rostro en tu selfie de probe coincide con algún rostro en la galería de selfies.

  • Detección de Vida: Asegura que la selfie de probe pertenece a una persona viva (no una foto o video) para prevenir fraudes.

Al utilizar esta API, puedes permitir o denegar el acceso a tu aplicación con confianza, basándote en si la selfie coincide y si proviene de una persona viva.


Cómo Funciona

  1. Envías una selfie (probe) y una galería de selfies a la API.

  2. La API compara el rostro de probe con cada rostro en la galería (comparación 1 a muchos).

  3. También verifica si la selfie de probe muestra a una persona viva mediante detección de vida.

  4. Recibes un resultado con puntajes, lo que te permite decidir si hay una coincidencia y si la persona está viva.

Ideal para:

  • Control de Acceso a Apps: Permite solo a usuarios verificados y vivos ingresar a tu aplicación.

  • KYC (Know Your Customer): Verifica identidades de usuarios para cumplir con regulaciones y mejorar la seguridad.


Mejores Prácticas

  • Seguridad: Mantén tu token de API seguro y usa HTTPS.

  • Calidad de Imagen: Usa selfies claras y bien iluminadas para obtener mejores resultados.

  • Pruebas: Realiza pruebas con diferentes dispositivos (iOS, Android) y tamaños de galería.

  • Umbrales: Comienza con los valores predeterminados de min_score, luego ajusta según falsos positivos/negativos.


Ejemplos

Solución de Problemas

¿Sin coincidencia?

  • Verifica la calidad de la imagen o intenta con el modo ACCURATE.

  • Asegúrate de que la galería contenga los rostros correctos.

¿Falla la detección de vida?

  • Asegúrate de que la selfie de probe sea una imagen en vivo (no una foto impresa).

  • Aumenta el valor de liveness_min_score si demasiadas verificaciones de vida fallan.

¿Errores?

  • Verifica tu token y la codificación en base64.


Lo que necesitas

  • Una selfie para comparar (probe)

  • Un conjunto de selfies para comparar (gallery).

  • Un token de API (obtenlo desde el dashboard de Verifik o desde las APIs de Autenticación)

¿Listo para integrar?

Sigue el ejemplo de código, prueba con tus selfies y ajusta los valores de puntaje para adaptarlos a las necesidades de tu aplicación.


Encabezados (Headers)

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

os

string

OS from where you are doing the operation. [DESKTOP, IOS, ANDROID]

probe

string

Face encoded in base64

gallery

Array

Array of images to compare with the face inside probe.

search_mode

string

search mode, it could be FAST, ACCURATE.

compare_min_score

number

Percentage for the minimum comparison between gallery and probe. (liveness will not be tested if the score is less than the minimum) [min 0.67 - max 0.95]

liveness_min_score

number

Percentage for the minimum value of the liveness test [ min 0.52 - max 1]

Ejemplo de Body

{
    "os": "DESKTOP",
    "probe": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAAAAAAD...",
    "gallery": [
        "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAAAAAAD...",
        "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAAAAAAD..."
    ],
    "search_mode": "FAST",
    "compare_min_score": 0.85,
    "liveness_min_score": 0.6
}

probe: La selfie única que deseas verificar. gallery: Una lista de selfies para comparar (puede incluir múltiples imágenes). compare_min_score: Define cuán similares deben ser los rostros (valor más alto = más estricto = mejor). liveness_min_score: Define el nivel de certeza de que la persona está viva (valor más alto = más estricto = más seguro).

Response

`
{
    "data": {
        "comparison": {
            "client": "613375a1eab2fe08527f81e2",
            "type": "compareLive",
            "search_mode": "ACCURATE",
            "gallery": [],
            "probe": [],
            "status": "success",
            "_id": "66e650d6b71ae4d43a76d95d",
            "comparedAt": "2024-09-15T03:13:26.392Z",
            "result": {
                "score": 1
            },
            "updatedAt": "2024-09-15T03:13:29.652Z",
            "createdAt": "2024-09-15T03:13:29.652Z",
            "__v": 0
        },
        "liveness": {
            "client": "613375a1eab2fe08527f81e2",
            "type": "liveness",
            "status": "success",
            "search_mode": "FAST",
            "os": "DESKTOP",
            "liveness_min_score": 0.7,
            "_id": "66e650d9b71ae4d43a76d95f",
            "result": {
                "liveness_score": 0.77,
                "passed": true,
                "min_score": 0.7
            },
            "updatedAt": "2024-09-15T03:13:31.675Z",
            "createdAt": "2024-09-15T03:13:31.675Z",
            "__v": 0
        }
    },
    "signature": {
        "dateTime": "September 15, 2024 3:13 AM",
        "message": "Certified by Verifik.co"
    },
    "id": "ABRCB"
}
{
    "code": "MissingParameter",
    "message": "missing search_mode\n"
}
 ---------------------------------------
{
    "code": "MissingParameter",
    "message": "missing probe\n"
}
---------------------------------------
{
    "code": "MissingParameter",
    "message": "missing gallery\n"
}

Estructura de la Respuesta

Comparación

  • client (String): Identificador único del cliente que realiza la solicitud de comparación.

  • type (String): Describe el tipo de comparación. En este caso, es compareLive para comparación de imágenes en vivo.

  • search_mode (String): Especifica el modo de búsqueda utilizado. Las opciones incluyen ACCURATE para comparaciones precisas.

  • status (String): Indica el éxito o el fallo de la solicitud de comparación. Valor esperado: success.

  • result (Object): Contiene los resultados de la comparación:

    • score (Number): Puntaje de la comparación. Un valor de 1 indica una coincidencia perfecta.

    • comparedAt (DateTime): Marca de tiempo de cuándo se realizó la comparación.

    • updatedAt (DateTime): Marca de tiempo de la última actualización.

    • createdAt (DateTime): Marca de tiempo de la creación de este registro.


Sección de Detección de Vida (Liveness)

  • client (String): Identificador único del cliente que realiza la solicitud de verificación de vida.

  • type (String): Especifica el tipo de prueba. En este caso, es liveness.

  • status (String): Indica el éxito o el fallo de la verificación de vida. Valor esperado: success.

  • search_mode (String): Modo de búsqueda utilizado para la detección de vida. En este caso, se usa el modo FAST.

  • os (String): Sistema operativo utilizado durante la verificación, por ejemplo, DESKTOP.

  • liveness_min_score (Number): Puntaje mínimo necesario para aprobar la verificación de vida. En este caso, el umbral es 0.6.

  • result (Object): Resultado de la verificación de vida:

    • liveness_score (Number): Puntaje obtenido en la prueba de detección de vida. Se logró un puntaje de 0.77.

    • passed (Boolean): Indica si la prueba de detección de vida fue aprobada. En este caso, true indica éxito.

    • min_score (Number): Puntaje mínimo necesario para aprobar. Para esta prueba, es 0.6.

  • updatedAt (DateTime): Marca de tiempo de la última actualización.

  • createdAt (DateTime): Marca de tiempo de la creación de este registro.

PreviousCompararNextComparar 1:1

Last updated 2 months ago