Vista previa HumanID

Inspecciona metadatos públicos de un ZelfProof. Sin rostro ni credenciales.

menu_bookReferencia API: Vista previa HumanIDexpand_more

Documentación oficial: docs.verifik.co/api/tags/preview-zelfproof (parámetros, respuestas y ejemplos). Esta demo llama a POST /v2/human-id/preview vía previewHumanId, alineado con ese flujo en la API actual. Relacionado: Crear un ZelfProof, Descifrar un 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/preview

Devuelve campos de vista previa no sensibles para una prueba (por ejemplo si se requiere contraseña) dentro del sobre data firmado habitual.

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

Parámetro	Obl.	Descripción
zelfProof	Sí	Cadena HumanID pegada o extraída del QR en este formulario
verifierKey	No	Si la prueba se creó con clave verificadora

await fetch("https://api.verifik.co/v2/human-id/preview", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    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 decodifica la carga y devuelve un zelfProof que puedes enviar a la llamada de vista previa anterior. Mismos encabezados JSON que la vista previa. Clave verificadora opcional si la prueba la usa.

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 vista previa 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,<...>",
  }),
});

Esta demo usa previewHumanId y, para imágenes QR, previewZelfIdQr de @humanauthn/api-client con tu token de sesión.
Las respuestas exitosas siguen el patrón Verifik: un objeto data (y a menudo signature cuando la firma está habilitada en tu proyecto).

menu_book

Guías oficiales en docs.verifik.co

POST

Vista previa ZelfProof

Referencia para inspeccionar metadatos públicos de una prueba antes de descifrarla o usarla en otro sitio.

POST

Crear un ZelfProof

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

POST

Descifrar un ZelfProof

Desbloquea la carga de identidad dentro de una prueba haciéndola coincidir con un rostro en vivo.

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. Independiente de la vista previa HumanID.

Vista previa HumanID

Documentación relacionada