Descriptografar HumanID

Recupere dados de identidade apresentando o rosto vivo correspondente.

menu_bookReferência da API: Decrypt HumanIDexpand_more

Guia oficial: docs.verifik.co/functions/decrypt-zelfproof (campos de requisição e resposta, senha e chave de verificador opcionais e exemplos de chamadas). Relacionado: Criar um ZelfProof, Criar QR ZelfProof, Preview 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/decrypt

Compara sua imagem facial à prova e retorna campos públicos descriptografados e payload relacionado (por exemplo recorte facial e dificuldade) no envelope de dados assinado habitual quando a correspondência tem sucesso.

Cabeçalho	Valor
Content-Type	application/json
Authorization	Bearer <token>

Param	Obrig.	Descrição
faceBase64	Sim	Imagem facial como base64 cru (esta demo usa o mesmo formato que outras demos biométricas)
os	Sim	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, IOS ou ANDROID (demo usa DESKTOP)
zelfProof	Sim	String HumanID da colagem ou da extração da imagem QR neste formulário
password	Não	Somente se a prova foi criada com senha
verifierKey	Não	Se a prova foi criada com chave de verificador

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

Use quando o usuário fornece PNG ou JPEG do QR HumanID. A API lê o payload do QR, executa o mesmo tipo de pré-visualização que a string e retorna um zelfProof para passar ao decrypt. verifierKey opcional quando a prova foi criada com um. Mesmos cabeçalhos JSON que decrypt.

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 no decrypt 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,<...>",
  }),
});

Decrypt usa decryptHumanId de @humanauthn/api-client. O upload de QR usa previewZelfIdQr primeiro; depois você descriptografa com a string de prova retornada.
Respostas de sucesso seguem o padrão Verifik: objeto data (e frequentemente assinatura quando a assinatura está habilitada no projeto).
Para inspecionar uma prova sem imagem facial, abra a demo Preview HumanID (previewHumanId) ou o guia Preview ZelfProof linkado acima.

menu_book

Guias oficiais em docs.verifik.co

POST

Descriptografar um ZelfProof

Desbloqueie o payload de identidade na prova correspondendo a um rosto vivo. Cobre senha opcional quando a prova foi criada com uma.

POST

Criar um ZelfProof

Criptografe seus campos públicos e captura facial em uma nova string HumanID para armazenar ou compartilhar.

POST

Preview ZelfProof

Inspecione metadados públicos e o que será exigido antes de descriptografar, sem enviar imagem facial. A demo Preview HumanID segue a mesma ideia na API atual.

POST

Criar QR ZelfProof

Gere um QR que embute um HumanID para escanear da tela ou carteira.

POST

Detecção de vivacidade

Execute uma verificação dedicada de que uma imagem facial parece viva e não spoof. Separado de criptografar e descriptografar HumanID.

Descriptografar HumanID

Documentação relacionada