الانتقال إلى المحتوى الرئيسي
The official Didit module for Go. It needs Go 1.22 or later and uses only the standard library. See the نظرة عامة على حزم SDK للخادم for what every SDK shares.

التثبيت

الوحدة متاحة في github.com/didit-protocol/sdk-go على pkg.go.dev. ويمكنك الاطلاع على المصدر وسجل التغييرات في didit-protocol/sdk-go على GitHub. اسم الحزمة هو didit. وتوجد حزمة webhook في github.com/didit-protocol/sdk-go/webhook، وAuthentication في .../authentication، وخيارات العميل في .../option. المثال الموجود في كل صفحة من مرجع API هو جسم دالة، ويستخدم context وfmt وlog من مكتبة Go القياسية وهذه الوحدة.

إعداد العميل

تقرأ didit.NewClient() القيمة DIDIT_API_KEY من متغيرات البيئة. مرّر خيارات لتجاوزها، أو لتعيين معرّفات المؤسسة والتطبيق التي تحتاجها الاستدعاءات المرتبطة بالتطبيق (الحالات والشبكات والتقارير التنظيمية). ويمكن أيضًا تطبيق أي خيار على استدعاء واحد.
الحقول الاختيارية في الطلب هي قيم من نوع didit.Opt. عيّنها باستخدام didit.String أو didit.Int أو didit.Bool أو didit.Float أو didit.Some، واتركها دون تعيين فلا يُرسَل أي شيء.

إنشاء جلسة

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

قراءة القرار

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

التحقق من webhook

مرّر بايتات جسم الطلب الخام وترويسات الطلب. تُرجع webhook.Verify القيمة *didit.WebhookVerificationError لأي تسليم غير صالح أو غير حديث، وتُرجع حدثًا مُنمّطًا في الحالة الأخرى.
أثناء تدوير السر، أضف السر القديم باستخدام webhook.WithSecrets. راجع Webhooks للاطلاع على الأحداث وآلية التوقيع.

فحص معاملة

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

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

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

الأخطاء

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

endpoints غير المتوفرة في Go SDK بعد

الإصدار Go 1.0.1 أُنشئ قبل إضافة هذه الـ endpoints إلى الـ API، لذلك لا توجد له دالة مخصصة لها، ولا تتضمن صفحاتها أمثلة بلغة Go: كما لا يمكنه إرسال حقول الطلب الأحدث هذه: إلى أن تضيفها إصدارات Go لاحقة، استدعِ هذه الـ endpoints عبر HTTP كما يوضح طلب cURL في كل صفحة. وتتضمن كل صفحة أخرى من صفحات endpoints الخادم في مرجع API مثالًا بلغة Go للعملية الخاصة بها.
آخر تعديل في ٧ نوفمبر ٢٠٢٦