التكامل مع Didit: واجهة API وSDK وwebhook

النص الكامل لفيديو التكامل مع Didit في تطبيقك: API وSDK وwebhook (دليل المطوّر) - الفيديو 8 من 10 في أكاديمية Didit، مدته 08:13. شاهده على YouTube. كل فقرة مرتبطة باللحظة الدقيقة لها في الفيديو.

​

ما الذي ستربطه

00:04 في هذا الفيديو، ستقوم بربط Didit بتطبيقك الخاص. فيتحقق مستخدموك من هويتهم داخل منتجك مباشرةً، وتصل كل نتيجة إلى نظامك لحظة حدوثها. هذا الفيديو موجّه للمطوّرين، لذا فهو تقني أكثر قليلاً، لكنه أبسط مما تتوقع. وبنهايته ستدرك أنك تستطيع أن تسلّم معظم العمل مباشرةً إلى Cloud Code ليبنيه لك. لذا سنمرّ عليه بالترتيب

​

مكوّنات الدمج الثلاثة: SDK وAPI وwebhook

00:28 الذي ستبني به ذلك فعلاً. هيا نبدأ. يتطلب دمج Didit ربط ثلاثة أشياء. يعرض SDK الكاميرا، والتقاط المستند، وقراءة NFC، وواجهة كشف الحيوية داخل تطبيقك مباشرةً. أما API فهو اتصال من خادم إلى خادم، إذ يُنشئ الخادم الخلفي الجلسة ويقرأ القرار المعتمد. ويستدعي webhook نقطة نهاية HTTPS الخاصة بك فور تغيّر حالة الجلسة، وهذا أسرع وأغنى بكثير من الاستعلام المتكرر (polling) عنها

​

تبويب التكامل

00:56 لذا فأسهل طريقة للدمج هي الانتقال إلى تبويب Manage ثم النقر على Integrate، ومن هنا يمكننا أخذ كل الإعدادات، فنأخذ مفتاح API الخاص بنا. يمكننا إعداد مفتاح API محدد لهذا التطبيق الذي نعمل عليه. ويمكننا إنشاء سير عمل نريد دمجه واختياره. ويمكننا إضافة webhook، وهنا تُرسل نتائج التحقق إليه. 01:24 أما سر التوقيع، الذي سأعرضه بعد لحظة، فهو ما سيُوضع

​

اختيار المنصة

01:28 في ملف ENV لديك. ثم يمكنك ربطه بتطبيقك. لدينا هنا عدة خيارات: Web JS وReact Native وiOS وAndroid وFlutter، وبعض الواجهات الأخرى. فاختر الخيار المناسب لتطبيقك. هذه هي أسرار البيئة التي ستضعها في ملف ENV لديك على

​

موجّه الإعداد بالذكاء الاصطناعي

01:48 خادمك. أسهل طريقة لإعداد ذلك هي استخدام موجّه الإعداد بالذكاء الاصطناعي. نضبط كل الإعدادات هنا، ثم ننسخ الموجّه، فيتضمن كل المعلومات ذات الصلة التي نحتاجها من الإعداد الذي أنجزناه هنا. ننسخه ونلصقه، ويمكننا وضعه في Cloud Code أو Codex أو في أي مكان تبني فيه

​

مفاتيح API، مفتاح لكل بيئة

02:09 تطبيقك. تُحفظ مفاتيح API هنا، وكل صف يحتوي على مفتاح واحد، حسنًا؟ لذلك فمن العادات الجيدة استخدام مفتاح منفصل لكل بيئة ولكل تكامل. بهذه الطريقة يمكنك تدوير مفتاح أو إلغاؤه دون أن تتعطل المفاتيح الأخرى. لذا، إذا كنت ستدمج سير عمل بعينه، فقد ترغب

​

إنشاء مفتاح

02:27 ببساطة في مفتاح API منفصل لسير العمل، على سبيل المثال. الآن، إذا نقرت على إنشاء مفتاح API، سأكتب هنا test فقط، ثم أنشئ مفتاح API. الآن يمكنني نسخه، صحيح؟ ولن أراه مرة أخرى. لذا من المهم أن تنسخه وربما تدوّنه في مكان ما كي تستخدمه عند إجراء التكامل. عندما تصل إلى قسم التكامل وتأخذ مفتاح API الخاص بك، ولنفترض أنني أخذت مفتاح test ونزلت للأسفل، أختار، حسنًا، نريد استخدام هذا… آه، لنرَ، سير عمل KYC. يمكننا إضافة webhook. 03:05 يمكننا ربط تطبيقنا، حسنًا. ثم نلصق موجّه الإعداد هنا. ترى هنا أن هذا الموجّه سيتضمن

​

نظرة عامة على webhook

03:13 مفتاح API. وننتقل الآن بسرعة إلى webhook، فيمكننا إعداد webhook لأي شيء نريده تقريبًا. فلنفترض أنك تريد إرسال حدث معيّن إلى Slack، صحيح؟ يمكننا

​

الوثائق

03:25 إضافة عنوان URL الخاص بالـ webhook هنا. حسنًا، لنلقِ نظرة على بعض الوثائق هنا، فلديك بالفعل إمكانية الوصول إلى كل الوثائق التقنية. فقط انتقل إلى docs.didit.me، وسنلقي نظرة على بعض الأمور

​

إنشاء الجلسة: الحقل الإلزامي الوحيد

03:37 هنا. كل شيء يدور حول إنشاء الجلسة. حسنًا، هذا طلب POST، وهو بداية عملية التحقق. ترى هنا في طلب curl أن لدينا معرّف سير العمل. وهذا هو الحقل الإلزامي الوحيد، والجزء المفيد حقًا أن نقطة النهاية نفسها تُنشئ جلسات KYC وKYB معًا. و

​

بيانات المورّد ورابط الاستدعاء

04:00 سير العمل هو ما يحدد أيّهما. لدينا بعض الحقول الإضافية هنا، بما في ذلك بيانات المورّد، التي تحدثنا عنها كثيرًا في هذه الفيديوهات. وهي تمثّل المعرّف الفريد لكل مستخدم، ويمكنك تحديده كما تشاء، سواء كان بريدًا إلكترونيًا أو معرّفًا فريدًا. ثم لدينا هنا رابط الاستدعاء، وهو المكان الذي يُنقل إليه المستخدم بعد إكمال سير عمل التحقق. لذا،

​

تجربة نقطة النهاية مباشرةً

04:24 إذا مررنا للأسفل هنا، يمكننا تجربة ذلك فعلاً. فإذا نقرنا على Try it، يمكننا إنشاء جلسة تحقق هنا. سألصق هنا أحد مفاتيح API. سأنشئ مفتاحًا جديدًا تمامًا، test two. سأنسخه وألصقه هنا. نريد الحصول على معرّف سير عمل، لذا ننتقل إلى هنا. يمكننا أخذ معرّف سير العمل من هنا وإدخاله هناك. بيانات المورّد غير مطلوبة. لنكتب مجرد سلسلة أرقام عشوائية. 05:02 أما رابط الاستدعاء فيمكننا إبقاؤه كما هو هنا. وبالمناسبة، لا شيء من هذا إلزامي. أعتقد أن السبب هو أن لدي حساب اختبار هنا، لكن إذا أردت اختبار نقطة النهاية هذه، فهذه هي الطريقة تمامًا. الآن، إذا كنت مطوّرًا وتريد إجابات محددة، يمكنك الاطلاع على الوثائق. كما أن MCP يتيح الوصول إلى كل هذه الوثائق، لذا يمكنك ببساطة دمج MCP وسؤال Claude عن أي استفسار تقني قد تجد إجابته في هذه الوثائق.

​

webhooks: لماذا لا نستخدم الاستطلاع المتكرر؟

05:32 داخل هذا القسم. لنتحدث الآن عن webhooks. يوجد لدينا تبويب هنا ضمن قسم الإدارة مخصص لـ webhooks، وهو الطريقة التي تصلك بها النتائج فعليًا. تُعد webhooks القناة الموصى بها، لأن الاستطلاع بطيء جدًا، و

​

إضافة وجهة webhook واختيار الأحداث

05:44 سيكلفك طلبات أكثر، ويُفوّت بعض الأحداث. لذا نضيف وجهة جديدة هنا. يمكننا لصق عنوان URL. ويمكننا اختيار الأحداث التي نريدها. إذن، هذه كل البيانات التي نريد إرسالها إلى endpoint هذه. وسيعيد لك Didit سر توقيع لمرة واحدة، وسأريك إياه بعد قليل. ويجب أن يكون عنوان URL قابلًا للوصول مباشرة، أي لا localhost ولا عناوين IP خاصة. لذا سأخرج من هنا، ويمكننا التمرير إلى الجانب الأيمن، وهناك عدة خيارات. 06:16 هنا نرى عدد الأحداث التي يستمع إليها هذا الـ webhook، ويمكننا

​

سر التوقيع

06:19 نسخ سر التوقيع، وهو مهم لتكاملك. عند إعداد التكامل في تبويب التكاملات، وقد شرحت ذلك، يوجد موجه، ثم سيكون سر التوقيع هنا للـ webhook الذي اخترته في الإعداد. لذا،

​

موجه إعداد معالج webhook

06:34 طريقة أخرى للاستفادة من الذكاء الاصطناعي، لدينا موجه جاهز وجدته في تبويب webhooks هنا. يمكننا أن نرى إن كنت تريد إعداد معالج webhook الخاص بك بالذكاء الاصطناعي. يمكنك الاطلاع على التوثيق والعثور على موجه التكامل هنا. يغطي هذا الموجه التحقق من الهوية والكيان والمعاملة، وسيبني كل شيء لك. فهو يوضح كل شيء: ما الذي يجب بناؤه، والرؤوس الخاصة بالتحقق من التوقيع، وأنواع أحداث webhook التي رأيتها للتو عند إعداد webhook سابقًا. لدينا أيضًا غلاف webhook وأشياء كثيرة أخرى، ويمكنك أيضًا اختيار المكان الذي تريد لصقه فيه، أي الأداة التي تستخدمها. 07:15 إذا أردت استخدام هذا الموجه، فهذه هي الطريقة السهلة للبدء وإعداد تكاملاتك. كل ما شرحته في هذا الفيديو متاح ويمكن الاستعلام عنه داخل أداة الذكاء الاصطناعي لديك إذا دمجت خادم MCP. يمكنك ببساطة أن تشرح باللغة الإنجليزية العادية ما تريد حدوثه، وسيقرأ Cloud Code التوثيق ويبني التكامل لك. أي أنك تكتفي بمراجعة العمل والتأكد من أنه يعمل و

​

الخلاصة

07:41 يعمل، بدلًا من كتابة كل شيء من الصفر. هكذا يصل Didit إلى تطبيقك: الـ SDK الذي يراه مستخدموك، والـ API الذي يستدعيه الخادم الخلفي لديك، وwebhook الموقّع الذي يوصل الحكم الذي تبني عليه. ثق بالـ webhook، واستخدم بيانات المورّد في كل مكان، واعتمد على موجه الإعداد حتى لا تضطر إلى توصيل الأجزاء المملة يدويًا. يمكنك التوجه إلى didit.me والتسجيل مجانًا، وإجراء عملية تحقق خلال دقائق.