الانتقال إلى المحتوى الرئيسي
حزمة Didit الرسمية لـ Ruby. تتطلب Ruby 3.1 أو أحدث، وتستخدم net/http من المكتبة القياسية. راجع نظرة عامة على حزم SDK من جانب الخادم لمعرفة ما تشترك فيه جميع الحزم.

التثبيت

الحزمة هي didit-sdk على RubyGems. يوجد مصدرها وسجل تغييراتها في didit-protocol/sdk-ruby على GitHub. أو أضف gem "didit-sdk" إلى ملف Gemfile الخاص بك، ثم نفّذ bundle install. حمّل الحزمة باستخدام require "didit".

إعداد العميل

يقرأ Didit::Client.new القيمة DIDIT_API_KEY من متغيرات البيئة. مرّر وسائط بالأسماء لتجاوزها، أو لتعيين معرّفات المؤسسة والتطبيق اللذين تحتاجهما الاستدعاءات المرتبطة بالتطبيق (الحالات والشبكات والتقارير التنظيمية). حقول الطلب هي وسائط بالأسماء باستخدام أسماء الحقول في API نفسه، أما الاستجابات فهي كائنات تحتوي على خاصية قراءة لكل حقل، ويمكن الوصول إليها عبر [:field] وto_h.

إنشاء جلسة

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

قراءة القرار

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

التحقق من webhook

مرّر النص الخام كما استُلم تمامًا، ومعه رؤوس الطلب. تُطلق الدالة verify الاستثناء Didit::WebhookVerificationError لأي تسليم غير صالح أو غير حديث، وتعيد حدثًا مُحدَّد النوع في الحالات الأخرى.
في Rails، استدعِ handle_webhook(request.raw_post, request.headers). أثناء تدوير السر، مرّر الاثنين معًا: [new_secret, old_secret]. راجع Webhooks للاطلاع على الأحداث ومخطط التوقيع.

فحص معاملة

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

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

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

الأخطاء

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

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