HumanIDプレビュー

HumanID をプレビューする

ZelfProof からのパブリックメタデータを検査します。顔も資格も必要ありません。

menu_bookAPI リファレンス: HumanID のプレビューexpand_more

公式ドキュメント: docs.verifik.co/api/tags/preview-zelfproof (パラメータ、応答、例)。このデモでは、previewHumanId 経由で POST /v2/human-id/preview を呼び出します。これは、現在の API のワークフローと一致します。関連している： 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 からのreviewZelfIdQr を使用します。
成功の応答は Verifik パターンに従います: データオブジェクト (プロジェクトで署名が有効になっている場合は、多くの場合署名)。

menu_book

docs.verifik.co の公式ガイド

POST

ZelfProof をプレビューする

公開メタデータを復号化したり他の場所で使用したりする前に、証明から公開メタデータを検査するためのリファレンス。

POST

ZelfProof を作成する

公開フィールドを暗号化し、保存または共有できる新しい HumanID 文字列に顔をキャプチャします。

POST

ZelfProof を復号化する

証明内の ID ペイロードを生きている顔と照合することで、そのペイロードのロックを解除します。

POST