HumanID 미리보기

ZelfProof에서 공개 메타데이터를 검사합니다. 얼굴이나 자격 증명이 필요하지 않습니다.

menu_bookAPI 참조: HumanID 미리보기expand_more

공식 문서: docs.verifik.co/api/tags/preview-zelfproof (매개변수, 응답 및 예시) 이 데모에서는 현재 API의 해당 워크플로와 일치하는 PreviewHumanId를 통해 POST /v2/human-id/preview을 호출합니다. 관련된: ZelfProof 생성, ZelfProof 암호 해독.

Base URL https://api.verifik.co. Send JSON with Content-Type: application/json and Authorization: Bearer <access token> (same JWT as this demo after sign in).

POST /v2/human-id/preview

일반적으로 서명된 데이터 봉투 내의 증거(예: 비밀번호가 필요한지 여부)에 대해 민감하지 않은 미리 보기 필드를 반환합니다.

헤더	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수	요청	설명
zelfProof	예	붙여넣기 또는 이 형식의 QR 추출에서 얻은 HumanID 문자열
verifierKey	아니요	검증자 키를 사용하여 증명이 생성된 경우

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

사용자가 HumanID QR의 PNG 또는 JPEG를 제공할 때 사용합니다. API는 페이로드를 디코딩하고 위의 미리보기 호출에 보낼 수 있는 zelfProof를 반환합니다. 미리보기와 동일한 JSON 헤더입니다. 증명에서 verifierKey를 사용하는 경우 선택적인 verifierKey입니다.

매개변수	요청	설명
zelfProofQRCode	예	데이터 URL(data:image/png;base64,...) 또는 API에서 허용하는 다른 형식의 이미지(이 데모는 파일에서 데이터 URL을 구축합니다)
verifierKey	아니요	증명에서 검증자 키를 사용할 때 미리보기와 동일한 의미

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

이 데모에서는 PreviewHumanId를 사용하고, QR 이미지의 경우 세션 토큰과 함께 @humanauthn/api-client의 PreviewZelfIdQr을 사용합니다.
성공 응답은 Verifik 패턴, 즉 데이터 개체(그리고 종종 프로젝트에 서명이 활성화될 때 서명)를 따릅니다.

menu_book

docs.verifik.co 공식 가이드

POST

ZelfProof 미리보기

공개 메타데이터를 해독하거나 다른 곳에서 사용하기 전에 증명에서 공개 메타데이터를 검사하기 위한 참조입니다.

POST

ZelfProof 생성

공개 필드와 얼굴 캡처를 저장하거나 공유할 수 있는 새로운 HumanID 문자열로 암호화하세요.

POST

ZelfProof 암호 해독

실제 얼굴과 일치시켜 증명 내의 신원 페이로드를 잠금 해제하세요.

POST