Xem trước HumanID

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-Typeapplication/json
AuthorizationBearer <token>
Thông sốyêu cầuSự miêu tả
zelfProofĐúngChuỗi HumanID từ dán hoặc từ trích xuất QR ở dạng này
verifierKeyKHÔNGNế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ầuSự miêu tả
zelfProofQRCodeĐúngHì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)
verifierKeyKHÔNGNgữ 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).
menu_book

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