Aperçu HumanID
Inspectez les métadonnées publiques d'un ZelfProof. Sans visage ni identifiants.
menu_bookRéférence API : Preview HumanIDexpand_more
Documentation officielle : docs.verifik.co/api/tags/preview-zelfproof (paramètres, réponses et exemples). Cette démo appelle POST /v2/human-id/preview via previewHumanId, aligné sur ce flux sur l'API actuelle. Associé : Créer un ZelfProof, Déchiffrer un 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/preview
Renvoie des champs d'aperçu non sensibles pour une preuve (par ex. si un mot de passe est requis) dans l'enveloppe de données signée habituelle.
| En-tête | Valeur |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req. | Description |
|---|---|---|
| zelfProof | Oui | Chaîne HumanID collée ou extraite du QR dans ce formulaire |
| verifierKey | Non | Si la preuve a été créée avec une clé de vérificateur |
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
Utilisez lorsque l'utilisateur fournit un PNG ou JPEG du QR HumanID. L'API décode la charge et renvoie un zelfProof à envoyer à l'appel d'aperçu ci-dessus. Mêmes en-têtes JSON. verifierKey facultatif lorsque la preuve en utilise une.
| 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'à l'aperçu 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,<...>",
}),
});- Cette démo utilise previewHumanId et, pour les images QR, previewZelfIdQr de @humanauthn/api-client avec le jeton de votre session.
- 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).
Documentation associée
Guides officiels sur docs.verifik.co
Preview ZelfProof
Référence pour inspecter les métadonnées publiques d'une preuve avant de la déchiffrer ou l'utiliser ailleurs.
Créer un ZelfProof
Chiffrez vos champs publics et la capture faciale dans une nouvelle chaîne HumanID à stocker ou partager.
Déchiffrer un ZelfProof
Déverrouillez la charge d'identité dans la preuve en la faisant correspondre à un visage vivant.
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é de l'aperçu HumanID.