الانتقال إلى المحتوى الرئيسي
الحزمة الرسمية من Didit للغة Python. تتطلب Python 3.10 أو أحدث، وتوفّر عميلاً متزامناً هو Didit وعميلاً غير متزامن هو AsyncDidit، وكلاهما يوفّر الطرق نفسها. راجع نظرة عامة على SDKs الخادم لمعرفة ما تشترك فيه جميع حِزم SDK.

التثبيت

الحزمة هي didit-sdk على PyPI. يوجد مصدرها وسجل التغييرات في didit-protocol/sdk-python على GitHub. للتحقق من token الخاصة بـ Authentication، ثبّت الإضافة التي تضيف فحص التوقيع:

إعداد العميل

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

إنشاء جلسة

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

قراءة القرار

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

التحقق من webhook

مرّر البايتات الخام لجسم الطلب بالضبط وترويسات الطلب. تُطلق verify الاستثناء WebhookVerificationError عند أي تسليم غير صالح أو قديم، لذا يكفي التقاط هذه الفئة وحدها.
في Flask يكون ذلك handle_webhook(request.get_data(), dict(request.headers))؛ وفي FastAPI يكون handle_webhook(await request.body(), request.headers). أثناء تدوير السر، مرّر الاثنين: [new_secret, old_secret]. راجع Webhooks للأحداث ومخطط التوقيع.

فحص معاملة

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

التحقق من token المصادقة

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

الأخطاء

القوائم والملفات والعمليات غير المتزامنة

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