HumanID entschlüsseln

Identitätsdaten wiederherstellen, indem Sie das passende Live-Gesicht vorlegen.

menu_bookAPI-Referenz: HumanID entschlüsselnexpand_more

Offizieller Leitfaden: docs.verifik.co/functions/decrypt-zelfproof (Anfrage- und Antwortfelder, optionales Passwort und Verifier-Key sowie Beispielaufrufe). Verwandt: Create a ZelfProof, Create QR ZelfProof, Preview ZelfProof.

Basis-URL https://api.verifik.co. JSON mit Content-Type: application/json und Authorization: Bearer <Zugriffstoken> (derselbe JWT wie in dieser Demo nach Anmeldung).

POST /v2/human-id/decrypt

Vergleicht Ihr Gesichtsbild mit dem Nachweis und liefert bei erfolgreichem Abgleich entschlüsselte öffentliche Felder und zugehörige Nutzdaten (z. B. Gesichtsausschnitt und Schwierigkeit) in der üblichen signierten data-Hülle.

Überschrift	Wert
Content-Type	application/json
Authorization	Bearer <token>

Parameter	Erf.	Beschreibung
faceBase64	Ja	Gesichtsbild als rohes Base64 (dieses Demoformat wie in anderen Biometrie-Demos)
os	Ja	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, IOS oder ANDROID (Demo nutzt DESKTOP)
zelfProof	Ja	HumanID-Zeichenkette aus Einfügen oder aus QR-Bild-Extraktion in diesem Formular
password	Nein	Nur wenn der Nachweis mit Passwort erstellt wurde
verifierKey	Nein	Wenn der Nachweis mit Verifier-Key erstellt wurde

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

Nutzen Sie dies, wenn der Nutzer ein PNG oder JPEG des HumanID-QR liefert. Die API liest die QR-Nutzdaten, führt dieselbe Art Vorschau wie bei einer Zeichenketten-Vorschau aus und liefert einen zelfProof für decrypt. Optional verifierKey, wenn der Nachweis mit einem erstellt wurde. Gleiche JSON-Header wie decrypt.

Parameter	Erf.	Beschreibung
zelfProofQRCode	Ja	Bild als Data-URL (data:image/png;base64,...) oder anderes von der API akzeptiertes Format (diese Demo erzeugt eine Data-URL aus der Datei)
verifierKey	Nein	Gleiche Semantik wie bei decrypt, wenn der Nachweis einen Verifier-Key nutzt

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 nutzt decryptHumanId aus @humanauthn/api-client. QR-Upload verwendet zuerst previewZelfIdQr, danach entschlüsseln Sie mit der zurückgegebenen Proof-Zeichenkette.
Erfolgsantworten folgen dem Verifik-Muster: ein data-Objekt (und oft eine Signatur, wenn Signierung für Ihr Projekt aktiv ist).
Zum Inspizieren eines Nachweises ohne Gesichtsbild öffnen Sie die Demo „HumanID-Vorschau“ (previewHumanId) oder den verlinkten Leitfaden „Preview ZelfProof“.

menu_book

Offizielle Anleitungen auf docs.verifik.co

POST

Decrypt a ZelfProof

Identitätsnutzdaten im Nachweis durch Abgleich mit einem Live-Gesicht freischalten. Optionales Passwort, wenn der Nachweis damit erstellt wurde.

POST

Create a ZelfProof

Öffentliche Felder und Gesichtserfassung in eine neue HumanID-Zeichenkette verschlüsseln, die Sie speichern oder teilen können.

POST

Preview ZelfProof

Öffentliche Metadaten und Anforderungen vor dem Entschlüsseln prüfen, ohne Gesichtsbild zu senden. Die Demo „HumanID-Vorschau“ folgt derselben Idee auf der aktuellen API.

POST

Create QR ZelfProof

QR erzeugen, der einen HumanID einbettet, damit Nutzer ihn vom Bildschirm oder Wallet scannen können.

POST

Liveness detection

Dedizierte Prüfung, ob ein Gesicht lebendig wirkt statt spoof. Getrennt von HumanID-Verschlüsselung und -Entschlüsselung.

HumanID entschlüsseln

Zugehörige Dokumentation