التثبيت
didit-protocol/sdk-php على Packagist. ويوجد المصدر وسجل التغييرات في didit-protocol/sdk-php على GitHub.
يحتاج التحقق من tokens الخاصة بـ المصادقة أيضاً إلى الامتداد openssl.
إعداد العميل
يقرأnew DiditClient() القيمة DIDIT_API_KEY من متغيرات البيئة. مرّر وسائط مسماة لتجاوزها، أو لتعيين معرّفات المؤسسة والتطبيق التي تحتاجها الاستدعاءات المرتبطة بالتطبيق (الحالات، والشبكات، والتقارير التنظيمية). تكون حقول الطلب مصفوفة واحدة بأسماء الحقول الخاصة بالـ API نفسها، أما الاستجابات فهي كائنات للقراءة فقط بخصائص بصيغة camelCase ودالة toArray().
إنشاء جلسة
أنشئ جلسة تحقق لسير عمل، ثم وجّه المستخدم إلى عنوانها URL.قراءة القرار
عندما ينهي المستخدم العملية (أو عند وصول الـ webhook)، اقرأ القرار. كل نتيجة لميزة هي قائمة تحتوي على عنصر واحد لكل عقدة في سير العمل.التحقق من webhook
مرّر الجسم الخام كما استُلم تماماً، ورؤوس الطلب. تُلقي الدالةverify الاستثناء WebhookVerificationException عند أي تسليم غير صالح أو غير حديث، وتعيد حدثاً مُحدَّد النوع في غير ذلك.
$request->getContent() و$request->headers->all(). مع طلب PSR-7، مرّر الطلب نفسه بدلاً من الترويسات. أثناء تدوير السر، مرّر الاثنين معاً: [$newSecret, $oldSecret]. راجع Webhooks للاطلاع على الأحداث ومخطط التوقيع.
فحص معاملة
أرسل دفعة أو سحباً أو تحويلاً بالعملات المشفرة إلى مراقبة المعاملات، وتتضمن الاستجابة حالتها ودرجة المخاطر الخاصة بها.التحقق من tokens الخاصة بالمصادقة
يتحققAuthentication من رموز الوصول التي يوقّعها مُصدر المصادقة الخاص بك، في الخادم الخلفي لديك، دون استدعاء Didit لكل طلب. مرّر ذاكرة تخزين مؤقت متوافقة مع PSR-16 حتى تُجلب مفاتيح المُصدر مرة واحدة، لا عند كل طلب. كما يتولى استبدال الرموز، وتحديث tokens، والتحقق من الجلسات وإلغائها، وتنفيذ عمليات التحقق الإضافية.
تنفّذ عملية التحقق من token الفحوصات الواردة في التحقق من token على الخادم، وذلك مقابل مُصدر تطبيقك ومفاتيح التوقيع الخاصة به.