Motimate: كيفية استخدام واجهة برمجة التطبيقات العامة لتوفير وإدارة المستخدمين والمجموعات؟

يمكنك توفير المستخدمين وإدارتهم في Motimate من خلال ربط نظامك المصدر بواجهة برمجة تطبيقات REST الخاصة بنا. يمكّنك هذا من التعامل مع العديد من المهام الأساسية في Motimate مثل إنشاء المستخدمين، وتحديث المستخدمين، وحذف المستخدمين، وإنشاء المجموعات، وتخصيص المستخدمين للمجموعات الصحيحة. 

معلومات أساسية: 

• لدى جميع المستخدمين والمجموعات معرّفات Motimate الفريدة الخاصة بهم والتي يمكن استخدامها مع واجهة برمجة التطبيقات، ولكن يمكنك أيضًا تحديد "معرّف خارجي" يمكنك استخدامه مع واجهة برمجة التطبيقات. عادةً ما يتم تعيين هذا "المعرف الخارجي" ليتطابق مع المعرف الموجود لديك لهذا المستخدم أو المجموعة في مصدر البيانات الخاص بك. 
   
• تُستخدم المجموعات لإنشاء تسلسل هرمي أو شجرة مجموعات. سيعكس هذا عادةً هيكل مؤسستك بشكل وثيق، ويُستخدم لتفويض التدريب والحصول على التقارير. وغالباً ما يعتمد ذلك إما على الأقسام والفرق أو المناطق. نوصي بإنشاء المجموعات قبل إنشاء المستخدمين بحيث يمكنك تعيين المستخدمين مباشرةً إلى المجموعات عند الإنشاء. انظر هنا لمزيد من المعلومات عن هيكل المجموعة.
   
• يسمح لك منصب المستخدم بتفويض التدريب بناءً على دوره في المؤسسة. انظر هنا لمزيد من المعلومات عن مراكز المستخدمين.
   
• نوصي بإعداد بيئة اختبار لاختبار مكالماتك وتكاملها ككل، قبل نقلها إلى بيئة الإنتاج. يُرجى الاتصال بمدير نجاح العملاء أو support@motimateapp.com للحصول على المساعدة. 
   
• تكون واجهة برمجة تطبيقات Motimate بتنسيق JSON. 

إنشاء المجموعات

لإنشاء مجموعات استخدم الاتصال التالي:
POST https://motimateapp.com/public_api/groups

أضف الحمولة إلى الجسم مع المعلومات اللازمة مع المجموعة. يُستخدم حقل "parent_id" لإنشاء بنية مجموعة. سيؤدي إدخال مُعرّف مجموعة مختلفة في هذا الحقل إلى تعيين تلك المجموعة كمجموعة أصل.

يرجى الملاحظة: يجب أن يكون مستوى المجموعة في التسلسل الهرمي الأدنى من المجموعة الأم، حيث أن "المستوى 1" هو أعلى مستوى. يتيح لك ذلك استيراد هياكل المجموعات إلى حساب Motimate الخاص بك. 

تحديث المجموعات 

لتحديث مجموعة في Motimate، ستحتاج إلى إجراء المكالمة التالية. المعرف المستخدم في هذا المثال هو معرف مجموعة Motimate. 

التصحيح https://motimateapp.com/public_api/groups/{group_id}

أضف الحمولة إلى الجسم مع البيانات الضرورية التي ترغب في تحديثها على المجموعات. يمكن استخدام ذلك عند الحاجة إلى نقل مجموعة إلى مستوى مختلف أو إذا كانت هناك حاجة إلى تعديل الهيكل. 

 

حذف المجموعات

لحذف مجموعة في Motimate، ستحتاج إلى إجراء المكالمة التالية. المعرف المستخدم في هذا المثال هو معرف مجموعة Motimate. سيؤدي ضبط القوة على '1' إلى تدمير السجل بشدة، ولا توجد طريقة لاستعادة المجموعة في هذا السيناريو.

حذف https://motimateapp.com/public_api/groups/{group_id}

سيؤدي تشغيل هذا الاستدعاء إلى حذف المجموعة المحددة، على الرغم من عدم إرجاع الرد:

 

إنشاء المستخدمين

لإنشاء مستخدمين، استخدم الاستدعاء التالي: 

البريد https://motimateapp.com/public_api/users

أضف الحمولة إلى الجسم مع المعلومات الضرورية للمستخدم. سيكون إما عنوان البريد الإلكتروني أو رقم الهاتف خانة إلزامية بناءً على إعدادات حسابك في Motimate. يمكنك تحديد مجموعات المستخدم باستخدام حقل تعيينات المجموعة. أدخل معرف المجموعة التي تريد أن يكون المستخدم جزءًا منها ودوره في المجموعة (عضو أو مسؤول أو مراقب). نوصي بتعيين assing_ancestors على "صواب" في الغالبية العظمى من السيناريوهات. وهذا يضمن أن يكون المستخدمون أعضاء في المجموعات الرئيسية للمجموعات المعينة لهم. 

 

تحديث المستخدمين

لتحديث معلومات المستخدم في Motimate، ستحتاج إلى إجراء المكالمة التالية. المعرف المستخدم في هذا المثال هو معرف المستخدم Motimate. 

التصحيح https://motimateapp.com/public_api/users/{user_id}?'identifier_type=ID

أضف الحمولة إلى الجسم مع البيانات الضرورية الوحيدة التي ترغب في تحديثها للمستخدم.

 

حذف المستخدمين

لحذف مستخدم في Motimate، ستحتاج إلى إجراء المكالمة التالية. المعرف المستخدم في هذا المثال هو معرف المستخدم Motimate. سيؤدي ضبط القوة على '1' إلى تدمير السجل بشدة، ولا توجد طريقة لاستعادة المجموعة في هذا السيناريو. سيؤدي تعيينه إلى "0" إلى حذف السجل بشكل ناعم، مما يسمح باستعادته إذا لزم الأمر. 

حذف https://motimateapp.com/public_api/users/{user_id}?force=1&identifier_type=id

سيؤدي تشغيل هذا الاستدعاء إلى حذف المستخدم المحدد، على الرغم من عدم إرجاع الرد: 

استعادة المستخدمين

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

التصحيح https://motimateapp.com/public_api/users/{user_id}/استعادة؟ identifier_type=id