الانتقال إلى المحتوى الرئيسي
المكتبة الرسمية لـDidit الخاصة بـJava وKotlin. تتطلب Java 11 أو إصدارًا أحدث، ولا تعتمد إلا على java.net.http وJackson وتعليقات JSpecify التوضيحية الخاصة بإمكان كون القيمة فارغة. يحتوي كل أسلوب على صيغة ...Async تُعيد قيمة من النوع CompletableFuture. راجع نظرة عامة على SDKs للخادم للاطلاع على ما تشترك فيه جميع حزم SDK.

التثبيت

تتوفر الحزمة me.didit:didit-java على Maven Central. وتتوفر شيفرتها المصدرية وسجل تغييراتها في didit-protocol/sdk-java على GitHub.

تهيئة العميل

new Didit() يقرأ DIDIT_API_KEY من متغيرات البيئة. استخدم أداة البناء لتجاوزه، أو لتعيين معرّفات المؤسسة والتطبيق اللازمة للاستدعاءات المرتبطة بالتطبيق (الحالات والشبكات والتقارير التنظيمية).
أنواع الطلبات عبارة عن أدوات بناء، وتتحقق build() من الحقول المطلوبة. حقول الاستجابة الاختيارية هي قيم من النوع Optional؛ وفي Kotlin، اقرأها باستخدام .getOrNull(). الأمثلة الواردة في هذه الصفحة وفي كل صفحة من مرجع API هي جسم الدالة، مع الاستيرادات اللازمة أعلاها.

إنشاء جلسة

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

قراءة القرار

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

التحقق من webhook

مرّر الجسم الخام كما تم استلامه، مع رؤوس الطلب. تُطلق Webhooks.verify الاستثناء WebhookVerificationException لأي حالة لا تمثل عملية تسليم صالحة وحديثة، وتعيد حدثًا مُحدد النوع في الحالات الأخرى.
في Spring Boot، خذ الجسم على هيئة @RequestBody byte[] body والرؤوس على هيئة @RequestHeader Map<String, String> headers. لقبول سرّين أثناء تدوير أحدهما، مرّر VerifyOptions. راجع webhook للاطلاع على الأحداث ومخطط التوقيع.

فحص معاملة

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

التحقق من رموز Authentication

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

الأخطاء

كل استثناء يرث من DiditException، وهو استثناء غير مفحوص.

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

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