كيفية إعداد الاتصال

أولاً، تحتاج إلى الحصول على مفتاح API. يمكنك العثور عليه في قسم الملف الشخصي في حسابك الشخصي على MyOwnConference

بعد نسخ المفتاح، افتح الإعدادات -> ثوابت المشروع في Mavibot والصقه في المتغير myownconference_api_key:

كل دالة تُرجع قاموسًا يحتوي على معامل status؛ يمكن أن تكون قيمته 0 أو 1.

إذا كانت status=1، فهذا يعني أن الطلب في MyOwnConference تم بنجاح وسيحمل المعامل result نتيجة الطلب، مثل:

{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}

أو تم الطلب بنجاح ولكن لم يتم العثور على شيء:

{'status': '1', 'result': []}

إذا كانت status=0، فهناك مشكلة وسيتم وصفها في error، مثل:

{"status":"0","error":"Webinar with alias "wenk-gjkc-teqp-nteh" not active"} {'status': '0', 'error': 'Missing required variables - email'}

كيفية البحث عن الندوات عبر الإنترنت

تُستخدم الدالة myownconference_find_webinars(date, status) للبحث عن الندوات عبر الإنترنت، حيث:

date - التاريخ بصيغة dd.mm.yyyy - اختيار الندوات لتاريخ محدد
status - القيمة 1 للندوات النشطة أو المستقبلية، 0 للندوات المنتهية

myownconference_find_webinars() - تُرجع مصفوفة جميع الندوات التي تم العثور عليها

تُرجع الدالة قاموسًا من هذا النوع:

في حالة النجاح (مثال):

{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}

في حالة الفشل (مثال):

{"status":"0","error":"Format not supported or date is not valid. Params must be yyyy-mm-dd"}

كيفية التحقق من وجود مستخدم في ندوة نشطة

الدالة myownconference_is_online_user(webinar_id, email)، حيث:

webinar_id - معرف الندوة، أو بمعنى آخر، القيمة "alias" من الطلب عند البحث عن الندوة
email - عنوان البريد الإلكتروني للمستخدم، إذا لم يتم مشاركته، فسيتم استخدام البريد الإلكتروني من المتغير email، إذا كان موجودًا

النتيجة إذا كانت الدالة ناجحة:

{"status":"1","result":true} - المستخدم موجود حاليًا في الندوة {"status":"1","result":false} - المستخدم غير موجود

النتيجة إذا كان هناك خطأ في الطلب:

{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}

كيفية الحصول على بيانات تاريخ المستخدم

الدالة myownconference_history_user(webinar_id, email)، حيث:

webinar_id - معرف الندوة، أو بمعنى آخر، القيمة "alias" من الطلب عند البحث عن الندوة
email - عنوان البريد الإلكتروني للمستخدم، إذا لم يتم مشاركته، فسيتم استخدام البريد الإلكتروني من المتغير email، إذا كان موجودًا

النتيجة في حالة النجاح:

في المعامل result ستكون هناك مصفوفة تحتوي على بيانات المستخدم

{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - لم يتم العثور على المستخدم

في حالة الفشل:

{'status': '0', 'error': 'Missing required variables - email'} - لم يتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في متغير email

مثال على الطلب والحصول على اسم المستخدم:

مثال على طلب الحصول على بيانات تاريخ المستخدم

مثال على نتيجة الطلب

كيفية التحقق من وجود مستخدم في قائمة جميع المشاركين

الدالة myownconference_is_our_user(email)، حيث:

email - عنوان البريد الإلكتروني للمستخدم، إذا لم يتم مشاركته، فسيتم استخدام البريد الإلكتروني من المتغير email، إذا كان موجودًا

النتيجة في حالة النجاح:

{"status":"1","result":true} - المستخدم موجود في قاعدة بياناتك {"status":"1","result":false} - لا يوجد مثل هذا المستخدم في قاعدة بياناتك

في حالة الفشل:

{'status': '0', 'error': 'Missing required variables - email'} - لم يتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في متغير email

كيفية إنشاء مشارك

تضيف هذه الدالة مشاركًا في الندوة إلى قائمة جميع المستخدمين. بعد الإنشاء الناجح، يمكن تسجيل هذا المستخدم في ندوة (المزيد عن ذلك أدناه)

الدالة myownconference_add_user(email)، حيث:

email - عنوان البريد الإلكتروني للمستخدم، إذا لم يتم مشاركته، فسيتم استخدام البريد الإلكتروني من المتغير email، إذا كان موجودًا

النتيجة في حالة النجاح:

{"status":"1","result":true} - تمت إضافة المستخدم إلى قائمة جميع المشاركين لديك

في حالة الفشل:

{'status': '0', 'error': 'Missing required variables - email'} - لم يتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في متغير email.

كيفية تسجيل مشارك في ندوة عبر الإنترنت

من الضروري طلب البريد الإلكتروني من العميل لإتمام التسجيل. أي شيء آخر اختياري.

الدالة myownconference_add_user_to_webinar(webinar_id, email)، حيث:

webinar_id - معرف الندوة، أو بمعنى آخر، القيمة "alias" من الطلب عند البحث عن الندوة
email - عنوان البريد الإلكتروني للمستخدم، إذا لم يتم مشاركته، فسيتم استخدام البريد الإلكتروني من المتغير email، إذا كان موجودًا

النتيجة في حالة النجاح:

{"status":"1","result":true} - تم تسجيل المستخدم في الندوة

في حالة الفشل:

{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}