التثبيت
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:- التحقق من عنوان
- حذف المعاملات دفعةً واحدة
- شبكات Travel Rule: الحصول على الشبكات، وطلب الوصول إلى شبكة، والحصول على استبيان الشبكة أو حفظه أو إرساله
- إثباتات المحافظ لـ Travel Rule: عرض إثباتات المحافظ بلقطات الشاشة والموافقة على أحدها أو رفضه
- Google Wallet، وهو غير متوفر في أي إصدار 1.0.1 حتى الآن: بدء التحقق عبر Google Wallet وإرسال استجابة المحفظة
biometric_consentوtagsوuser_stateعند إنشاء جلسةbiometric_consent_modeعند تحديث إعدادات الـ webhookbeneficiary_vaspعند تحديث تحويل Travel Ruleconfirm_delete، وهو مطلوب عند حذف تقرير نهائي- الحقول الـ16 الأحدث في التحقق من قواعد البيانات، وغير متوفرة في أي إصدار 1.0.1