Déchiffrer un HumanID
Récupérez les données d'identité en présentant le visage vivant correspondant.
menu_bookRéférence API : Decrypt HumanIDexpand_more
Guide officiel : docs.verifik.co/functions/decrypt-zelfproof (champs requête et réponse, mot de passe et clé de vérificateur facultatifs, exemples d'appels). Associé : Créer un ZelfProof, Créer un QR ZelfProof, Preview ZelfProof.
URL de base https://api.verifik.co. Envoyez du JSON avec Content-Type: application/json et Authorization: Bearer <access token> (même JWT que cette démo après connexion).
POST /v2/human-id/decrypt
Compare votre image faciale à la preuve et renvoie les champs publics déchiffrés et la charge associée (par ex. recadrage facial et difficulté) dans l'enveloppe de données signée habituelle lorsque la correspondance réussit.
| En-tête | Valeur |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req. | Description |
|---|---|---|
| faceBase64 | Oui | Image faciale en base64 brut (cette démo utilise le même format que les autres démos biométriques) |
| os | Oui | DESKTOP, IOS, or ANDROID — DESKTOP, IOS ou ANDROID (démo utilise DESKTOP) |
| zelfProof | Oui | Chaîne HumanID collée ou extraite de l'image QR dans ce formulaire |
| password | Non | Uniquement si la preuve a été créée avec un mot de passe |
| verifierKey | Non | Si la preuve a été créée avec une clé de vérificateur |
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
Utilisez lorsque l'utilisateur fournit un PNG ou JPEG du QR HumanID. L'API lit la charge du QR, exécute le même type d'aperçu que pour une chaîne et renvoie un zelfProof à passer au decrypt. verifierKey facultatif lorsque la preuve a été créée avec une. Mêmes en-têtes JSON que decrypt.
| Param | Req. | Description |
|---|---|---|
| zelfProofQRCode | Oui | Image en data URL (data:image/png;base64,...) ou autre forme acceptée par l'API (cette démo construit une data URL à partir du fichier) |
| verifierKey | Non | Même sémantique qu'au decrypt lorsque la preuve utilise une clé de vérificateur |
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 utilise decryptHumanId de @humanauthn/api-client. Le téléversement QR utilise previewZelfIdQr d'abord ; puis vous déchiffrez avec la chaîne de preuve renvoyée.
- Les réponses de succès suivent le modèle Verifik : objet data (et souvent signature lorsque la signature est activée sur le projet).
- Pour inspecter une preuve sans image faciale, ouvrez la démo Preview HumanID (previewHumanId) ou le guide Preview ZelfProof lié ci-dessus.
Documentation associée
Guides officiels sur docs.verifik.co
Déchiffrer un ZelfProof
Déverrouillez la charge d'identité dans la preuve en la faisant correspondre à un visage vivant. Couvre le mot de passe facultatif lorsque la preuve a été créée avec un.
Créer un ZelfProof
Chiffrez vos champs publics et la capture faciale dans une nouvelle chaîne HumanID à stocker ou partager.
Preview ZelfProof
Inspectez les métadonnées publiques et ce qui sera exigé avant de déchiffrer, sans envoyer d'image faciale. La démo Preview HumanID suit la même idée sur l'API actuelle.
Créer un QR ZelfProof
Générez un QR intégrant un HumanID à scanner depuis un écran ou un portefeuille.
Détection de vivacité
Exécutez un contrôle dédié pour vérifier qu'une image faciale semble vivante et non spoof. Séparé du chiffrement et déchiffrement HumanID.