Validación biometrica

POST /veriface/validate HTTP/1.1
HOST: {{api_auco}}
Authorization: {{private_key}}

Servicio para obtener la similitud entre un documento de identidad y la fotografia de la persona mediante algoritmos de IA, validando la autenticidad de las fotos.

Autenticación

Incluye tu llave privada en el encabezado Authorization.

Authorization: prk_xxx...

Parámetros de consulta

Nombre	Descripción
photo String	Obligatorio. Imagen del rostro de la persona en base64 o la URL pública para acceder a la imagen. La imagen debe estar en formato JPEG o PNG.
documentImage String	Obligatorio. Imagen del documento en base64 o la URL pública para acceder a la imagen. La imagen debe estar en formato JPEG o PNG.

📥 Ejemplos de respuesta

Validación exitosa.

{
  "error": false,
  "similarity": 89.46871185302734,
  "code": "JPJD42IDWP3Z6RXA"
}

Validación fallida.

{
  "error": true,
  "similarity": 49.4231344,
  "code": "JPJD42IDWP3Z6RXA"
}

🧪 Ejemplos de uso

Curl

curl -X POST '{{api_auco}}/veriface/validate' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "photo": "https://url.com/photo.jpg",
    "documentImage": "https://url.com/document.jpg"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/veriface/validate',
  headers={'Authorization': '{{private_key}}'},
  json={
    "photo": "https://url.com/photo.jpg",
    "documentImage": "https://url.com/document.jpg"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/veriface/validate', {
  photo: 'https://url.com/photo.jpg',
  documentImage: 'https://url.com/document.jpg'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

⚠️ Respuestas de error

Código	Descripción
400	Faltan parámetros como photo o documentImage. Formato incorrecto de imagen.
401	Autenticación inválida o ausente.