Pré-visualizar HumanID

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çalhoValor
Content-Typeapplication/json
AuthorizationBearer <token>
ParamObrig.Descrição
zelfProofSimString HumanID da colagem ou da extração QR neste formulário
verifierKeyNãoSe 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.

ParamObrig.Descrição
zelfProofQRCodeSimImagem como data URL (data:image/png;base64,...) ou outro formato aceito pela API (esta demo monta data URL a partir do arquivo)
verifierKeyNãoMesma 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).
menu_book

Guias oficiais em docs.verifik.co