معاينة HumanID

معاينة HumanID

اطلع على البيانات الوصفية العامة من ZelfProof. لا حاجة لوجه أو بيانات اعتماد.

menu_bookمرجع API: معاينة HumanIDexpand_more

الوثائق الرسمية: docs.verifik.co/api/tags/preview-zelfproof (المعاملات والاستجابات والأمثلة). يستدعي هذا العرض POST /v2/human-id/preview عبر previewHumanId، بما يطابق ذلك السير على واجهة البرمجة الحالية. ذات صلة: إنشاء ZelfProof, فك تشفير ZelfProof.

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

POST /v2/human-id/preview

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

العنوانالقيمة
Content-Typeapplication/json
AuthorizationBearer <token>
المعاملإلزاميالوصف
zelfProofنعمسلسلة HumanID من اللصق، أو من استخراج QR في هذا النموذج
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

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

المعاملإلزاميالوصف
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,<...>",
  }),
});
  • يستخدم هذا العرض previewHumanId ولصور QR، previewZelfIdQr من @humanauthn/api-client مع رمز الجلسة.
  • تتبع الاستجابات الناجحة نمط Verifik: كائن بيانات (وغالبًا توقيع عند تفعيل التوقيع للمشروع).
menu_book

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