İnsan Kimliğinin şifresini çöz

İnsan Kimliğinin şifresini çöz

Eşleşen canlı yüzü sunarak kimlik verilerini kurtarın.

menu_bookAPI referansı: İnsan Kimliğinin Şifresini Çözmeexpand_more

Resmi kılavuz: docs.verifik.co/functions/decrypt-zelfproof (istek ve yanıt alanları, isteğe bağlı parola ve doğrulama anahtarı ve örnek çağrılar). İlgili: ZelfProof oluşturun, QR ZelfProof oluşturun, ZelfProof'u önizle.

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/decrypt

Yüz resminizi kanıtla karşılaştırır, ardından eşleşme başarılı olduğunda şifresi çözülmüş genel alanları ve ilgili yükü (örneğin yüz kırpma ve zorluk) olağan imzalı veri zarfı içinde döndürür.

BaşlıkDeğer
Content-Typeapplication/json
AuthorizationBearer <token>
ParamZorunluAçıklama
faceBase64EvetHam base64 olarak yüz görüntüsü (bu demo diğer biyometrik demolarla aynı formatı kullanır)
osEvetDESKTOP, IOS, or ANDROIDMASAÜSTÜ, IOS veya ANDROID (demo MASAÜSTÜ'nü kullanır)
zelfProofEvetYapıştırma işleminden veya bu formdaki QR görüntü çıkarma işleminden elde edilen HumanID dizesi
passwordHayırYalnızca kanıtın bir parolayla oluşturulmuş olması durumunda
verifierKeyHayırKanıt bir doğrulama anahtarıyla oluşturulduysa
await fetch("https://api.verifik.co/v2/human-id/decrypt", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    faceBase64: "<base64>",
    os: "DESKTOP",
    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 bunu kullanın. API, QR yükünü okur, dize önizlemesiyle aynı türde önizlemeyi çalıştırır ve şifre çözme işlemine aktarabileceğiniz bir zelfProof döndürür. İsteğe bağlı verifierKey, kanıt bir anahtarla oluşturulduğunda uygulanır. Şifre çözmeyle aynı JSON başlıkları.

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ırKanıt bir doğrulama anahtarı kullandığında şifre çözme işlemiyle 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,<...>",
  }),
});
  • Şifre çözme, @humanauthn/api-client'teki decryptHumanId'yi kullanır. QR yüklemesi önce önizlemeZelfIdQr'yi kullanır, ardından döndürülen kanıt dizesiyle şifreyi çözersiniz.
  • Başarı yanıtları Verifik modelini takip eder: bir veri nesnesi (ve genellikle projeniz için imzalama etkinleştirildiğinde bir imza).
  • Bir kanıtı yüz görüntüsü olmadan incelemek için Preview HumanID demosunu (previewHumanId) veya yukarıda bağlantısı verilen Preview ZelfProof kılavuzunu açın.
menu_book

docs.verifik.co üzerindeki resmi kılavuzlar