الانتقال إلى المحتوى الرئيسي
المكتبة الرسمية من Didit لـ PHP. تتطلب PHP 8.1 أو أحدث، وتعمل مع أي عميل HTTP متوافق مع PSR-18، ويُعد Guzzle الخيار الشائع. اطّلع على نظرة عامة على حزم SDK للخادم لمعرفة ما تشترك فيه جميع الحزم.

التثبيت

الحزمة هي 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 عند أي تسليم غير صالح أو غير حديث، وتعيد حدثاً مُحدَّد النوع في غير ذلك.
في Laravel وSymfony، مرّر $request->getContent() و$request->headers->all(). مع طلب PSR-7، مرّر الطلب نفسه بدلاً من الترويسات. أثناء تدوير السر، مرّر الاثنين معاً: [$newSecret, $oldSecret]. راجع Webhooks للاطلاع على الأحداث ومخطط التوقيع.

فحص معاملة

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

التحقق من tokens الخاصة بالمصادقة

يتحقق Authentication من رموز الوصول التي يوقّعها مُصدر المصادقة الخاص بك، في الخادم الخلفي لديك، دون استدعاء Didit لكل طلب. مرّر ذاكرة تخزين مؤقت متوافقة مع PSR-16 حتى تُجلب مفاتيح المُصدر مرة واحدة، لا عند كل طلب. كما يتولى استبدال الرموز، وتحديث tokens، والتحقق من الجلسات وإلغائها، وتنفيذ عمليات التحقق الإضافية.
تنفّذ عملية التحقق من token الفحوصات الواردة في التحقق من token على الخادم، وذلك مقابل مُصدر تطبيقك ومفاتيح التوقيع الخاصة به.

الأخطاء

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

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