إضافة معرف فريد للتكامل

لإعداد تكامل مع Dotcom-Monitor ، يجب أن يكون لديك حق الوصول إلى حساب Dotcom-Monitor نشط وإنشاء معرف فريد لواجهة برمجة تطبيقات الويب لاستخدامه في طلب المصادقة:

  1. قم بتسجيل الدخول إلى حساب Dotcom-Monitor.
  2. في Dotcom-Monitor، قم بإنشاء UID تكامل ضمن تكوين > عمليات > التكامل إضافة تكامل واجهة برمجة تطبيقات ويب للتكامل>.
  3. قم بإضافة عناوين IP إلى القائمة البيضاء كما هو موضح في مقالة كيفية إضافة عناوين IP للوصول إلى واجهة برمجة تطبيقات الويب في القائمة البيضاء على موقع wiki الخاص بنا.
  4. اختياري: إذا كان الحساب الرئيسي يحتوي على الأقسام وتريد الوصول إلى واجهة برمجة التطبيقات الخاصة بقسم معين وإرسالها إليها، في النافذة إضافة تكامل ، حدد السماح بالوصول إلى بيانات القسم.
  5. انقر فوق إنشاء تكامل وانسخ المعرف الفريد لواجهة برمجة تطبيقات الويب من قائمة معرفات UID للتكامل إلى الحافظة (واجهة برمجة تطبيقات الويب (مع إمكانية الوصول إلى بيانات القسم) في حالة وصول القسم).

المصادقه

طلب عنوان URL

منصب https://api.dotcom-monitor.com/config_api_v1/login

عند تسجيل الدخول إلى حسابك عبر مكالمة “/login” ، تبدأ جلسة عميل جديدة. تنتهي صلاحية الجلسات تلقائيا بعد فترة محددة مسبقا من عدم النشاط. الافتراضي هو 1 دقيقة. إذا أجريت مكالمة API، إعادة تعيين مؤقت عدم النشاط إلى الصفر.
عند انتهاء صلاحية جلسة العمل، يتم إرجاع رمز الخطأ HTTP الاستثناء “401 – غير مصرح به”. إذا حدث هذا ، فيجب عليك إعادة تسجيل الدخول مرة أخرى.

بعد التفويض، يتم تحديد العميل بواسطة ملف تعريف الارتباط، لذا تأكد من تمكين ملفات تعريف الارتباط.

نشر المحتوى

استخدم معرف الويب الفريد لواجهة برمجة التطبيقات كقيمة معلمة UID (تكوين > عمليات > التكامل إضافة تكامل واجهة برمجة تطبيقات ويب للتكامل>).

{
"UID":"1423e214d153d123123"
}

الوصول إلى معرف القسم

للوصول إلى بيانات القسم عبر واجهة برمجة التطبيقات، تحتاج إلى إنشاء تكامل واجهة برمجة تطبيقات الويب (مع إمكانية الوصول إلى بيانات القسم ). استخدم المعرف الفريد المقابل كمعلمة UID بالاقتران مع ” الإجراء”: زوج الاسم/القيمة 1 في طلب المصادقة.

استخدم نموذج محتوى المنشور التالي:

{ 
"UID" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Action": 1
}

وسيستجيب النظام بقائمة معرفات الإدارات المتاحة. انظر مثال JSON أدناه.

{
    "Success": true,
    "Result": [
        {
            "Name": "my_org",
            "HasCompany": true,
            "HasDepartment": true,
            "Qantity": 2,
            "Accounts": [
                {
                    "Id": 15530,
                    "Name": "my_org",
                    "CompanyName": "my company",
                    "Email": "email@gmail.com",
                    "Owner": true,
                    "Department": false,
                    "New": false
                },
                {
                    "Id": 19357,
                    "Name": "Admin",
                    "CompanyName": "my company",
                    "Email": "email111@gmail.com",
                    "Owner": true,
                    "Department": true,
                    "New": false
                }
            ]
        }
    ]
}

انسخ معرف القسم الذي تريد تسجيل الدخول إليه واستخدمه مع UID لإنشاء طلب مصادقة إلى القسم.

استخدم نموذج المشاركة الوارد أدناه.

{ 
"UID" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
 "Id" : "XXXX"
}

حيث ” UID”:”XXXXX…. XXX ” هي واجهة برمجة تطبيقات الويب الخاصة بك (مع إمكانية الوصول إلى بيانات القسم) UID و ” Id”: “XXXX” هو معرف القسم الخاص بك.

الاستجابة للنجاح

{
"Success":true,
"Result":"OK"
}