HumanID-Vorschau

Öffentliche Metadaten aus einem ZelfProof prüfen. Kein Gesicht oder zusätzliche Anmeldedaten nötig.

menu_bookAPI-Referenz: HumanID-Vorschauexpand_more

Offizielle Dokumentation: docs.verifik.co/api/tags/preview-zelfproof (Parameter, Antworten und Beispiele). Diese Demo ruft POST /v2/human-id/preview über previewHumanId auf — entspricht diesem Ablauf auf der aktuellen API. Verwandt: Create a ZelfProof, Decrypt a 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/preview

Liefert nicht sensible Vorschau-Felder für einen Nachweis (z. B. ob ein Passwort erforderlich ist) in der üblichen signierten data-Hülle.

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

Parameter	Erf.	Beschreibung
zelfProof	Ja	HumanID-Zeichenkette aus Einfügen oder aus QR-Extraktion in diesem Formular
verifierKey	Nein	Wenn der Nachweis mit Verifier-Key erstellt wurde

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

Nutzen Sie dies, wenn der Nutzer ein PNG oder JPEG des HumanID-QR liefert. Die API decodiert die Nutzdaten und liefert einen zelfProof für den obigen Vorschau-Aufruf. Gleiche JSON-Header wie Vorschau. Optional verifierKey, wenn der Nachweis einen nutzt.

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 der Vorschau, 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,<...>",
  }),
});

Diese Demo nutzt previewHumanId und für QR-Bilder previewZelfIdQr aus @humanauthn/api-client mit Ihrem Sitzungstoken.
Erfolgsantworten folgen dem Verifik-Muster: ein data-Objekt (und oft eine Signatur, wenn Signierung für Ihr Projekt aktiv ist).

menu_book

Offizielle Anleitungen auf docs.verifik.co

POST

Preview ZelfProof

Referenz zum Prüfen öffentlicher Metadaten eines Nachweises vor Entschlüsselung oder anderer Nutzung.

POST

Create a ZelfProof

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

POST

Decrypt a ZelfProof

Identitätsnutzdaten im Nachweis durch Abgleich mit einem Live-Gesicht freischalten.

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-Vorschau.

HumanID-Vorschau

Zugehörige Dokumentation