Giải mã HumanID

Khôi phục dữ liệu nhận dạng bằng cách hiển thị khuôn mặt trực tiếp phù hợp.

menu_bookTham khảo API: Giải mã HumanIDexpand_more

Hướng dẫn chính thức: docs.verifik.co/functions/decrypt-zelfproof (các trường yêu cầu và phản hồi, mật khẩu tùy chọn và khóa xác minh cũng như các lệnh gọi ví dụ). Có liên quan: Tạo ZelfProof, Tạo QR ZelfProof, Xem trước ZelfProof.

URL cơ sở https://api.verifik.co. Gửi JSON với Content-Type: application/json và Authorization: Bearer <access token> (Giống JWT như trong bản demo này sau khi đăng nhập).

POST /v2/human-id/decrypt

So sánh hình ảnh khuôn mặt của bạn với bằng chứng, sau đó trả về các trường công khai đã được giải mã và tải trọng liên quan (ví dụ: cắt khuôn mặt và độ khó) bên trong phong bì dữ liệu đã ký thông thường khi khớp thành công.

tiêu đề	Giá trị
Content-Type	application/json
Authorization	Bearer <token>

Thông số	yêu cầu	Sự miêu tả
faceBase64	Đúng	Hình ảnh khuôn mặt dưới dạng base64 thô (bản demo này sử dụng định dạng tương tự như các bản demo sinh trắc học khác)
os	Đúng	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP, iOS hoặc ANDROID (bản demo sử dụng DESKTOP)
zelfProof	Đúng	Chuỗi HumanID từ dán hoặc từ trích xuất hình ảnh QR ở dạng này
password	KHÔNG	Chỉ khi bằng chứng được tạo bằng mật khẩu
verifierKey	KHÔNG	Nếu bằng chứng được tạo bằng khóa xác minh

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

Sử dụng tùy chọn này khi người dùng cung cấp PNG hoặc JPEG của QR HumanID.API đọc tải trọng QR, chạy cùng loại bản xem trước như bản xem trước chuỗi và trả về zelfProof mà bạn có thể chuyển sang giải mã.verifierKey tùy chọn áp dụng khi bằng chứng được tạo bằng một.Tiêu đề JSON giống như giải mã.

Thông số	yêu cầu	Sự miêu tả
zelfProofQRCode	Đúng	Hình ảnh dưới dạng URL dữ liệu (data:image/png;base64,...) hoặc một dạng khác được API chấp nhận (bản demo này tạo URL dữ liệu từ tệp)
verifierKey	KHÔNG	Ngữ nghĩa tương tự như khi giải mã khi bằng chứng sử dụng khóa xác minh

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

Giải mã sử dụng decryptHumanId từ @humanauthn/api-client.Tải lên QR trước tiên sử dụng PreviewZelfIdQr, sau đó bạn giải mã bằng chuỗi bằng chứng được trả về.
Phản hồi thành công tuân theo mẫu Verifik: một đối tượng dữ liệu (và thường là chữ ký khi ký được bật cho dự án của bạn).
Để kiểm tra bằng chứng không có hình ảnh khuôn mặt, hãy mở bản demo Xem trước HumanID (previewHumanId) hoặc hướng dẫn Xem trước ZelfProof được liên kết ở trên.

menu_book

Hướng dẫn chính thức trên docs.verifik.co

POST

Giải mã ZelfProof

Mở khóa tải trọng nhận dạng bên trong bằng chứng bằng cách khớp nó với khuôn mặt trực tiếp.Che mật khẩu tùy chọn khi bằng chứng được tạo bằng một mật khẩu.

POST

Tạo ZelfProof

Mã hóa các trường công khai và tính năng chụp khuôn mặt của bạn thành chuỗi HumanID mới mà bạn có thể lưu trữ hoặc chia sẻ.

POST

Xem trước ZelfProof

Kiểm tra siêu dữ liệu công khai và những gì sẽ được yêu cầu trước khi bạn giải mã mà không cần gửi hình ảnh khuôn mặt.Bản demo Preview HumanID tuân theo ý tưởng tương tự trên API hiện tại.

POST

Tạo QR ZelfProof

Tạo mã QR nhúng HumanID để mọi người có thể quét mã đó từ màn hình hoặc ví.

POST

Phát hiện sự sống

Chạy kiểm tra chuyên dụng để đảm bảo hình ảnh khuôn mặt trông sống động chứ không phải giả mạo.Điều này tách biệt với mã hóa và giải mã HumanID.

Giải mã HumanID

Tài liệu liên quan