预览 HumanID

从 ZelfProof 查看公开元数据。无需人脸或凭证。

menu_bookAPI 参考：预览 HumanIDexpand_more

官方文档： docs.verifik.co/api/tags/preview-zelfproof （参数、响应与示例）。本演示通过 previewHumanId 调用 POST /v2/human-id/preview，与当前 API 上的该流程一致。相关：创建 ZelfProof, 解密 ZelfProof.

基础 URL 为 https://api.verifik.co。使用 Content-Type: application/json 与 Authorization: Bearer <access token> 发送 JSON（与本演示登录后的 JWT 相同）。

POST /v2/human-id/preview

在常见的签名 data 信封内返回证明的非敏感预览字段（例如是否需要密码）。

字段	值
Content-Type	application/json
Authorization	Bearer <token>

参数	必填	说明
zelfProof	是	来自粘贴的 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 二维码的 PNG 或 JPEG 时使用。API 解码载荷并返回可发送到上述预览调用的 zelfProof。与预览使用相同的 JSON 头。证明使用验证密钥时可选 verifierKey。

参数	必填	说明
zelfProofQRCode	是	图像为 data URL（data:image/png;base64,...）或 API 接受的其他形式（本演示由文件构建 data 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,<...>",
  }),
});