Xem trước HumanID
Kiểm tra siêu dữ liệu công khai từ ZelfProof.Không cần khuôn mặt hoặc thông tin xác thực.
menu_bookTham chiếu API: Xem trước HumanIDexpand_more
Tài liệu chính thức: docs.verifik.co/api/tags/preview-zelfproof (tham số, phản hồi và ví dụ). Demo này gọi POST /v2/human-id/preview qua previewHumanId, khớp quy trình đó trên API hiện tại. Liên quan: Tạo ZelfProof, Giải mã 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/preview
Trả về các trường xem trước không nhạy cảm cho bằng chứng (ví dụ: có cần mật khẩu hay không) bên trong phong bì dữ liệu đã ký thông thường.
| tiêu đề | Giá trị |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Thông số | yêu cầu | Sự miêu tả |
|---|---|---|
| zelfProof | Đúng | Chuỗi HumanID từ dán hoặc từ trích xuất QR ở dạng này |
| 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/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
Sử dụng khi người dùng cung cấp PNG hoặc JPEG của QR HumanID.API giải mã tải trọng và trả về zelfProof mà bạn có thể gửi tới lệnh gọi xem trước ở trên.Tiêu đề JSON giống như bản xem trước.VerifierKey tùy chọn khi bằng chứng sử dụng một.
| 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 xem trước 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,<...>",
}),
});- Bản demo này sử dụng PreviewHumanId và đối với hình ảnh QR, PreviewZelfIdQr từ @humanauthn/api-client bằng mã thông báo phiên của bạn.
- 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).
Tài liệu liên quan
Hướng dẫn chính thức trên docs.verifik.co
Xem trước ZelfProof
Tài liệu tham khảo để kiểm tra siêu dữ liệu công khai từ bằng chứng trước khi bạn giải mã hoặc sử dụng nó ở nơi khác.
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ẻ.
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.
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í.
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.Tách biệt khỏi bản xem trước HumanID.