Descifrar HumanID

Recupera datos de identidad presentando el rostro en vivo coincidente.

menu_bookReferencia API: Descifrar HumanIDexpand_more

Guía oficial: docs.verifik.co/functions/decrypt-zelfproof (campos de petición y respuesta, contraseña opcional y clave verificadora, y llamadas de ejemplo). Relacionado: Crear un ZelfProof, Crear QR ZelfProof, Vista previa ZelfProof.

URL base https://api.verifik.co. Envía JSON con Content-Type: application/json y Authorization: Bearer <token de acceso> (el mismo JWT que esta demo tras iniciar sesión).

POST /v2/human-id/decrypt

Compara tu imagen facial con la prueba y devuelve los campos públicos descifrados y la carga relacionada (por ejemplo recorte facial y dificultad) dentro del sobre data habitual firmado cuando la coincidencia tiene éxito.

Cabecera	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetro	Obl.	Descripción
faceBase64	Sí	Imagen facial en base64 cruda (esta demo usa el mismo formato que otras demos biométricas)
os	Sí	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, IOS o ANDROID (la demo usa DESKTOP)
zelfProof	Sí	Cadena HumanID pegada o extraída de imagen QR en este formulario
password	No	Solo si la prueba se creó con contraseña
verifierKey	No	Si la prueba se creó con clave verificadora

await fetch("https://api.verifik.co/v2/human-id/decrypt", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    faceBase64: "<base64>",
    os: "DESKTOP",
    zelfProof: "<human id string>",
  }),
});

POST /v2/human-id/preview-zelf-id-qr

Úsalo cuando el usuario proporciona un PNG o JPEG del QR de HumanID. La API lee la carga del QR, ejecuta el mismo tipo de vista previa que la cadena y devuelve un zelfProof que puedes pasar al descifrado. La clave verificadora opcional aplica si la prueba se creó con una. Mismos encabezados JSON que el descifrado.

Parámetro	Obl.	Descripción
zelfProofQRCode	Sí	Imagen como URL de datos (data:image/png;base64,...) u otra forma aceptada por la API (esta demo construye una URL de datos desde el archivo)
verifierKey	No	Misma semántica que en descifrado cuando la prueba usa clave verificadora

await fetch("https://api.verifik.co/v2/human-id/preview-zelf-id-qr", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    zelfProofQRCode: "data:image/png;base64,<...>",
  }),
});

El descifrado usa decryptHumanId de @humanauthn/api-client. La subida por QR usa previewZelfIdQr primero y luego descifras con la cadena devuelta.
Las respuestas exitosas siguen el patrón Verifik: un objeto data (y a menudo signature cuando la firma está habilitada en tu proyecto).
Para inspeccionar una prueba sin imagen facial, abre la demo Vista previa HumanID (previewHumanId) o la guía Preview ZelfProof enlazada arriba.

menu_book

Guías oficiales en docs.verifik.co

POST

Descifrar un ZelfProof

Desbloquea la carga de identidad dentro de una prueba haciéndola coincidir con un rostro en vivo. Cubre contraseña opcional si la prueba se creó con una.

POST

Crear un ZelfProof

Cifra tus campos públicos y la captura facial en una nueva cadena HumanID que puedes almacenar o compartir.

POST

Vista previa ZelfProof

Inspecciona metadatos públicos y qué se requerirá antes de descifrar, sin enviar imagen facial. La demo Vista previa HumanID sigue la misma idea en la API actual.

POST

Crear QR ZelfProof

Genera un QR que incrusta un HumanID para escanearlo desde pantalla o billetera.

POST

Detección de prueba de vida

Ejecuta una comprobación dedicada de que un rostro parece vivo y no falsificado. Es independiente del cifrado y descifrado HumanID.

Descifrar HumanID

Documentación relacionada