معاينة 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-Type | application/json |
| Authorization | Bearer <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: كائن بيانات (وغالبًا توقيع عند تفعيل التوقيع للمشروع).
الوثائق ذات الصلة
أدلة رسمية على docs.verifik.co
معاينة ZelfProof
مرجع لفحص البيانات الوصفية العامة من الدليل قبل فك التشفير أو استخدامه في مكان آخر.
إنشاء ZelfProof
شفّر حقولك العامة ولقطة الوجه في سلسلة HumanID جديدة للتخزين أو المشاركة.
فك تشفير ZelfProof
افتح حمولة الهوية داخل الدليل بمطابقتها لوجه حي.
إنشاء QR لـ ZelfProof
ولّد رمز QR يضم HumanID ليمسحه المستخدمون من شاشة أو محفظة.
كشف الحضور الحي
شغّل فحصًا مخصصًا لأن صورة الوجه تبدو حية لا مزيفة. منفصل عن معاينة HumanID.