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 لأي حالة لا تمثل عملية تسليم صالحة وحديثة، وتعيد حدثًا مُحدد النوع في الحالات الأخرى.
@RequestBody byte[] body والرؤوس على هيئة @RequestHeader Map<String, String> headers. لقبول سرّين أثناء تدوير أحدهما، مرّر VerifyOptions. راجع webhook للاطلاع على الأحداث ومخطط التوقيع.
فحص معاملة
أرسل دفعة أو سحبًا أو تحويلًا بالعملات المشفرة إلى مراقبة المعاملات؛ تتضمن الاستجابة حالتها ودرجة المخاطر الخاصة بها.التحقق من رموز Authentication
تتحققAuthentication من رموز الوصول التي يوقّعها المُصدِر الخاص بك في Authentication، وذلك في الخادم الخلفي دون استدعاء Didit لكل طلب. كما تستبدل الرموز، وتجدد الرموز، وتتحقق من الجلسات وتلغيها، وتشغّل الترقية إلى مستوى مصادقة أعلى.
يُجري التحقق من الرمز الفحوصات الواردة في التحقق من رمز على الخادم الخاص بك، وذلك مقابل المُصدِر ومفاتيح التوقيع الخاصة بتطبيقك.
الأخطاء
كل استثناء يرث منDiditException، وهو استثناء غير مفحوص.