الانتقال إلى المحتوى الرئيسي
POST
cURL
استخدم هذه العملية مع محفظة تحتوي استجابة البدء الخاصة بها على next_action.type = request_digital_credential، مثل Google Wallet. صادِق باستخدام مفتاح API الخاص بالتطبيق الذي بدأ عملية التحقق، من الخادم الخلفي لديك. أرسل بالضبط ما أعادته المحفظة: {protocol, data} من navigator.credentials.get في المتصفح، أو credentialJson بعد تحليله من Android Credential Manager. الرد مشفّر لصالح Didit، لذا لا تعدّله. يتحقق Didit من توقيع الجهة المُصدِرة مقابل جذور الجهات المُصدِرة الموثوقة لديه، ومن كل قيمة مُعادة مقابل الملخص الموقّع لها، ومن توقيع الجهاز على origin لديك وعلى هذا الطلب، ثم يبتّ في عملية التحقق. يمكن إرسال الرد مرة واحدة فقط. يُعيد الإرسال الثاني عملية التحقق التي سبق البتّ فيها. إذا كانت عملية التحقق لا تتطلب ردًّا من المحفظة، فإنها تُجيب بالرمز 409 مع error: "not_a_digital_credentials_wallet". راجع واجهات برمجة تطبيقات محفظة الهوية الرقمية للاطلاع على التسلسل الكامل، بما في ذلك مقتطفات المتصفح وAndroid.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

request_id
string<uuid>
مطلوب

قيمة request_id التي أرجعها الـ endpoint للبدء.

الجسم

ما أجابت به المحفظة صفحتك أو تطبيقك، بالنسبة لعملية تحقق من نوع request_digital_credential.

response
object
مطلوب

ما أرجعته المحفظة تماماً: {protocol, data} لـ DigitalCredential من navigator.credentials.get، أو credentialJson المحلل لـ DigitalCredential الخاص بنظام Android. مشفر لـ Didit؛ لا تقم بتعديله.

الاستجابة

عملية تحقق مستقلة واحدة من المحفظة، كما تُجيب عنها كل endpoint للمحفظة.

request_id
string<uuid>
مطلوب
wallet_verification
object
مطلوب
vendor_data
string | null
مطلوب
metadata
object | null
مطلوب

كائن البيانات الوصفية المرسل في البداية، أو null.

created_at
string<date-time>
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦