فك تشفير HumanID

استرجع بيانات الهوية بعرض الوجه الحي المطابق.

menu_bookمرجع API: فك تشفير HumanIDexpand_more

الدليل الرسمي: docs.verifik.co/functions/decrypt-zelfproof (حقول الطلب والاستجابة، وكلمة المرور الاختيارية ومفتاح المدقق، وأمثلة الاستدعاء). ذات صلة: إنشاء ZelfProof, إنشاء QR لـ ZelfProof, معاينة ZelfProof.

عنوان الأساس https://api.verifik.co. أرسل JSON مع Content-Type: application/json وAuthorization: Bearer <رمز الوصول> (نفس JWT بعد تسجيل الدخول).

POST /v2/human-id/decrypt

يقارن صورة وجهك بالدليل، ثم يعيد الحقول العامة المفكوكة والحمولة ذات الصلة (مثل قص الوجه والصعوبة) داخل غلاف البيانات الموقّع المعتاد عند نجاح المطابقة.

العنوان	القيمة
Content-Type	application/json
Authorization	Bearer <token>

المعامل	إلزامي	الوصف
faceBase64	نعم	صورة الوجه كـ base64 خام (نفس تنسيق العروض القياسية الحيوية الأخرى)
os	نعم	`DESKTOP`, `IOS`, or `ANDROID` — DESKTOP أو IOS أو ANDROID (العرض يستخدم DESKTOP)
zelfProof	نعم	سلسلة HumanID من اللصق، أو من استخراج صورة QR في هذا النموذج
password	لا	فقط إذا وُلِّد الدليل بكلمة مرور
verifierKey	لا	إذا وُلِّد الدليل بمفتاح مدقق

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

استخدمه عندما يوفّر المستخدم PNG أو JPEG لرمز QR الخاص بـ HumanID. تقرأ واجهة البرمجة حمولة QR وتشغّل معاينة مماثلة لمعاينة السلسلة، وتعيد zelfProof يمكن تمريره إلى فك التشفير. يطبق verifierKey الاختياري عند إنشاء الدليل بواحد. نفس ترويسات JSON كفك التشفير.

المعامل	إلزامي	الوصف
zelfProofQRCode	نعم	صورة كعنوان بيانات (data:image/png;base64,...) أو شكل آخر تقبله واجهة البرمجة (يبني هذا العرض عنوان بيانات من الملف)
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,<...>",
  }),
});

يستخدم فك التشفير decryptHumanId من @humanauthn/api-client. رفع QR يستخدم previewZelfIdQr أولًا، ثم تفك التشفير بسلسلة الدليل المُرجعة.
تتبع الاستجابات الناجحة نمط Verifik: كائن بيانات (وغالبًا توقيع عند تفعيل التوقيع للمشروع).
لفحص دليل دون صورة وجه، افتح عرض معاينة HumanID (previewHumanId) أو دليل معاينة ZelfProof المرتبط أعلاه.

menu_book

أدلة رسمية على docs.verifik.co

POST

فك تشفير ZelfProof

افتح حمولة الهوية داخل الدليل بمطابقتها لوجه حي. يغطي كلمة المرور الاختيارية عند إنشاء الدليل بها.

POST

إنشاء ZelfProof

شفّر حقولك العامة ولقطة الوجه في سلسلة HumanID جديدة للتخزين أو المشاركة.

POST

معاينة ZelfProof

اطلع على البيانات الوصفية العامة وما سيُطلَب قبل فك التشفير، دون إرسال صورة وجه. عرض معاينة HumanID يتبع الفكرة نفسها على واجهة البرمجة الحالية.

POST