الانتقال إلى المحتوى الرئيسي
مكتبة Didit الرسمية لـ C# و.NET. وتستهدف .NET 8 و.NET Standard 2.0، وجميع طرق API غير متزامنة (async). في .NET Framework، استخدم C# 11 أو إصدارًا أحدث. راجع نظرة عامة على حزم SDK للخادم لمعرفة ما تشترك فيه جميع حزم SDK.

التثبيت

لاستخدام حقن التبعيات في ASP.NET Core، أضف أيضًا Didit.Extensions.DependencyInjection وسجّل العميل باستخدام services.AddDidit(). الحزمتان هما Didit وDidit.Extensions.DependencyInjection على NuGet. مصدرهما وسجل التغييرات موجودان في didit-protocol/sdk-dotnet على GitHub.

إعداد العميل

يقرأ new DiditClient() القيمة DIDIT_API_KEY من متغيرات البيئة. مرّر DiditClientOptions لتجاوز هذه القيمة، أو لتعيين معرّفات المؤسسة والتطبيق التي تحتاجها الاستدعاءات الخاصة بنطاق التطبيق (الحالات والشبكات والتقارير التنظيمية). أنشئ عميلًا واحدًا وأعد استخدامه.
الخصائص المطلوبة في الطلب معلَّمة بالكلمة required، لذلك يفشل التجميع إذا غابت إحداها. الخصائص الاختيارية التي تتركها دون تعيين لا تُرسل.

إنشاء جلسة

أنشئ جلسة تحقق لسير عمل، ثم أرسل المستخدم إلى عنوان URL الخاص بها.

قراءة القرار

عندما ينتهي المستخدم (أو عندما يصل الـ webhook)، اقرأ القرار. نتيجة كل ميزة هي قائمة تحتوي على إدخال واحد لكل عقدة في سير العمل.

التحقق من webhook

مرّر الجسم الخام كما وصل تمامًا، ومرّر طريقة لقراءة رؤوس الطلب. تُطلق DiditWebhooks.Verify الاستثناء WebhookVerificationException لأي إرسال غير صالح أو قديم، وتعيد حدثًا مُحددَ النوع في الحالات الأخرى.
في واجهة API صغيرة من نوع minimal API في ASP.NET Core، اقرأ الجسم باستخدام StreamReader ومرّر name => request.Headers[name].FirstOrDefault(). أثناء تدوير السر، مرّر الاثنين معًا: new[] { newSecret, oldSecret }. راجع Webhooks للاطلاع على الأحداث ومخطط التوقيع.

فحص المعاملة

أرسل الدفعة أو السحب أو التحويل بالعملات الرقمية إلى مراقبة المعاملات؛ تتضمن الاستجابة حالتها ودرجة المخاطر.

التحقق من رموز token الخاصة بـ Authentication

تتحقق Authentication من رموز token للوصول التي يوقّعها مُصدر Authentication الخاص بك، داخل الخادم الخلفي، دون استدعاء Didit في كل طلب. كما تستبدل الرموز، وتحدّث رموز token، وتتحقق من الجلسات وتلغيها، وتشغّل عمليات رفع مستوى التحقق.
يُجري التحقق من token الفحوصات الواردة في التحقق من token على الخادم، مقابل مُصدر تطبيقك ومفاتيح التوقيع الخاصة به.

الأخطاء

القوائم والملفات

تحتوي صفحات endpoint الخاصة بالخادم في مرجع API على عينة .NET لعمليتها، باستثناء النقاط والحقول التي لم يصدر بعد أي إصدار 1.0.1 يدعمها، وهي مذكورة في النظرة العامة.
آخر تعديل في ٧ نوفمبر ٢٠٢٦