HumanID'yi önizle

HumanID'yi önizle

ZelfProof'tan genel meta verileri inceleyin. Yüze veya kimlik bilgilerine gerek yok.

menu_bookAPI referansı: HumanID'yi önizleyinexpand_more

Resmi belgeler: docs.verifik.co/api/tags/preview-zelfproof (parametreler, yanıtlar ve örnekler). Bu demo, mevcut API'deki iş akışıyla eşleşen ön izlemeHumanId aracılığıyla POST /v2/human-id/preview öğesini çağırır. İlgili: ZelfProof oluşturun, ZelfProof'un şifresini çözme.

Temel URL https://api.verifik.co. JSON'u Content-Type: application/json ve Authorization: Bearer <access token> ile gönderin (oturum açtıktan sonra bu demoyla aynı JWT).

POST /v2/human-id/preview

Her zamanki imzalı veri zarfının içinde bir kanıt için (örneğin bir parolanın gerekli olup olmadığı) hassas olmayan önizleme alanlarını döndürür.

BaşlıkDeğer
Content-Typeapplication/json
AuthorizationBearer <token>
ParamZorunluAçıklama
zelfProofEvetYapıştırma işleminden veya bu formdaki QR çıkarma işleminden elde edilen HumanID dizesi
verifierKeyHayırKanıt bir doğrulama anahtarıyla oluşturulduysa
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

Kullanıcı HumanID QR'nin PNG veya JPEG dosyasını sağladığında kullanın. API, yükün kodunu çözer ve yukarıdaki önizleme çağrısına gönderebileceğiniz bir zelfProof döndürür. Önizlemeyle aynı JSON başlıkları. Kanıt bir tane kullandığında isteğe bağlı verifierKey.

ParamZorunluAçıklama
zelfProofQRCodeEvetVeri URL'si (data:image/png;base64,...) veya API tarafından kabul edilen başka bir form olarak resim (bu demo, dosyadan bir veri URL'si oluşturur)
verifierKeyHayırProva bir doğrulama anahtarı kullandığında önizlemedekiyle aynı anlambilim
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,<...>",
  }),
});
  • Bu demo, önizlemeHumanId'yi ve QR görüntüleri için oturum belirteciniz ile birlikte @humanauthn/api-client'tan önizlemeZelfIdQr'yi kullanır.
  • Başarı yanıtları Verifik modelini takip eder: bir veri nesnesi (ve genellikle projeniz için imzalama etkinleştirildiğinde bir imza).
menu_book

docs.verifik.co üzerindeki resmi kılavuzlar