Dekripsi HumanID

Pulihkan data identitas dengan menunjukkan wajah hidup yang cocok.

menu_bookReferensi API: Dekripsi HumanIDexpand_more

Panduan resmi: docs.verifik.co/functions/decrypt-zelfproof (bidang permintaan dan respons, kata sandi opsional dan kunci verifikator, serta contoh panggilan). Terkait: Buat ZelfProof, Buat QR ZelfProof, Pratinjau ZelfProof.

Base URL https://api.verifik.co. Kirim JSON dengan Content-Type: application/json dan Authorization: Bearer <access token> (JWT sama seperti demo ini setelah masuk).

POST /v2/human-id/decrypt

Membandingkan gambar wajah Anda ke bukti, lalu mengembalikan bidang publik terdekripsi dan payload terkait (misalnya crop wajah dan difficulty) di dalam amplop data bertanda tangan biasa saat kecocokan berhasil.

Header	Nilai
Content-Type	application/json
Authorization	Bearer <token>

Param	Wajib	Deskripsi
faceBase64	Ya	Gambar wajah sebagai base64 mentah (demo ini memakai format sama seperti demo biometrik lain)
os	Ya	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, IOS, atau ANDROID (demo memakai DESKTOP)
zelfProof	Ya	String HumanID dari tempel, atau dari ekstraksi gambar QR di formulir ini
password	Tidak	Hanya jika bukti dibuat dengan kata sandi
verifierKey	Tidak	Jika bukti dibuat dengan kunci verifikator

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

Gunakan saat pengguna memberikan PNG atau JPEG QR HumanID. API membaca payload QR, menjalankan jenis pratinjau yang sama seperti pratinjau string, dan mengembalikan zelfProof yang dapat Anda masukkan ke dekripsi. verifierKey opsional berlaku saat bukti dibuat dengan satu. Header JSON sama seperti dekripsi.

Param	Wajib	Deskripsi
zelfProofQRCode	Ya	Gambar sebagai data URL (data:image/png;base64,...) atau bentuk lain yang diterima API (demo ini membangun data URL dari file)
verifierKey	Tidak	Semantik sama seperti pada dekripsi saat bukti memakai kunci verifikator

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

Dekripsi memakai decryptHumanId dari @humanauthn/api-client. Unggah QR memakai previewZelfIdQr terlebih dahulu, lalu Anda mendekripsi dengan string bukti yang dikembalikan.
Respons sukses mengikuti pola Verifik: objek data (dan sering signature saat penandatanganan diaktifkan untuk proyek Anda).
Untuk memeriksa bukti tanpa gambar wajah, buka demo Pratinjau HumanID (previewHumanId) atau panduan Pratinjau ZelfProof yang ditautkan di atas.

menu_book

Panduan resmi di docs.verifik.co

POST

Dekripsi ZelfProof

Buka payload identitas di dalam bukti dengan mencocokkannya ke wajah hidup. Mencakup kata sandi opsional saat bukti dibuat dengannya.

POST

Buat ZelfProof

Enkripsi bidang publik dan tangkapan wajah ke string HumanID baru yang dapat Anda simpan atau bagikan.

POST

Pratinjau ZelfProof

Periksa metadata publik dan apa yang akan diperlukan sebelum Anda mendekripsi, tanpa mengirim gambar wajah. Demo Pratinjau HumanID mengikuti ide yang sama pada API saat ini.

POST

Buat QR ZelfProof

Hasilkan QR yang menyematkan HumanID agar orang dapat memindai dari layar atau dompet.

POST

Deteksi keaktifan

Jalankan pemeriksaan khusus bahwa gambar wajah tampak hidup daripada spoof. Terpisah dari enkripsi dan dekripsi HumanID.

Dekripsi HumanID

Dokumentasi terkait