الانتقال إلى المحتوى الرئيسي
المكتبة الرسمية لـ Didit الخاصة بـ Node.js وTypeScript. تعمل على Node.js 18 أو أحدث وعلى Bun وDeno وبيئات Edge التي تدعم fetch، وتتوفر بإصدارين: ES module وCommonJS، ولا تعتمد على أي حزم إضافية في وقت التشغيل. اطلع على نظرة عامة على حزم SDK للخادم لمعرفة ما تشترك فيه جميع الحزم.

التثبيت

الحزمة هي @didit-protocol/sdk-node على npm. يوجد مصدرها وسجل تغييراتها في didit-protocol/sdk-node على GitHub.

إعداد العميل

يقرأ new Didit() القيمة DIDIT_API_KEY من متغيرات البيئة على Node.js وBun وDeno (مع --allow-env). لا تملك بيئات Edge متغيرات بيئة للعملية، لذا مرّر المفتاح كخيار في هذه البيئات: new Didit({ apiKey: env.DIDIT_API_KEY }). مرّر الخيارات لتجاوز مفتاح API المحدد في البيئة، أو لتعيين معرّفات المؤسسة والتطبيق التي تحتاجها الاستدعاءات المرتبطة بالتطبيق (الحالات والشبكات والتقارير التنظيمية). تُقاس مهلة الانتظار بالمللي ثانية.
مع CommonJS، استخدم const { Didit } = require("@didit-protocol/sdk-node");.

إنشاء جلسة

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

قراءة القرار

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

التحقق من webhook

مرّر النص الخام للطلب (وليس JSON محلّلاً) وترويسات الطلب: كائن req.headers في Node.js أو Express، أو كائن Headers في Fetch، أو أزواج [name, value] (النوع WebhookHeaders). تعيد الدالة verify وعداً، وترفض بـ WebhookVerificationError أي تسليم غير صالح أو قديم.
مع Express، اقرأ النص باستخدام express.raw({ type: "application/json" }) واستدعِ handleWebhook(req.body, req.headers). أثناء تدوير السر المشترك، مرّر السرين معاً: [newSecret, oldSecret]. انظر Webhooks للاطلاع على الأحداث وآلية التوقيع.

فحص معاملة

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

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

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

الأخطاء

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

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