Pré-visualizar HumanID
Inspecione metadados públicos de um ZelfProof. Sem face ou credenciais.
menu_bookReferência da API: Preview HumanIDexpand_more
Documentação oficial: docs.verifik.co/api/tags/preview-zelfproof (parâmetros, respostas e exemplos). Esta demo chama POST /v2/human-id/preview via previewHumanId, alinhado a esse fluxo na API atual. Relacionado: Criar um ZelfProof, Descriptografar um ZelfProof.
URL base https://api.verifik.co. Envie JSON com Content-Type: application/json e Authorization: Bearer <access token> (mesmo JWT desta demo após entrar).
POST /v2/human-id/preview
Retorna campos de pré-visualização não sensíveis para uma prova (por exemplo se senha é exigida) no envelope de dados assinado habitual.
| Cabeçalho | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Obrig. | Descrição |
|---|---|---|
| zelfProof | Sim | String HumanID da colagem ou da extração QR neste formulário |
| verifierKey | Não | Se a prova foi criada com chave de verificador |
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
Use quando o usuário fornece PNG ou JPEG do QR HumanID. A API decodifica o payload e retorna um zelfProof para enviar à chamada de pré-visualização acima. Mesmos cabeçalhos JSON. verifierKey opcional quando a prova usa uma.
| Param | Obrig. | Descrição |
|---|---|---|
| zelfProofQRCode | Sim | Imagem como data URL (data:image/png;base64,...) ou outro formato aceito pela API (esta demo monta data URL a partir do arquivo) |
| verifierKey | Não | Mesma semântica que na pré-visualização quando a prova usa chave de verificador |
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 e, para imagens QR, previewZelfIdQr de @humanauthn/api-client com o token da sua sessão.
- Respostas de sucesso seguem o padrão Verifik: objeto data (e frequentemente assinatura quando a assinatura está habilitada no projeto).
Documentação relacionada
Guias oficiais em docs.verifik.co
Preview ZelfProof
Referência para inspecionar metadados públicos de uma prova antes de descriptografar ou usar em outro lugar.
Criar um ZelfProof
Criptografe seus campos públicos e captura facial em uma nova string HumanID para armazenar ou compartilhar.
Descriptografar um ZelfProof
Desbloqueie o payload de identidade na prova correspondendo a um rosto vivo.
Criar QR ZelfProof
Gere um QR que embute um HumanID para escanear da tela ou carteira.
Detecção de vivacidade
Execute uma verificação dedicada de que uma imagem facial parece viva e não spoof. Separado da pré-visualização HumanID.