اتصل بفريق دعم Dotcom-Monitor لتلقي حق الوصول إلى وظيفة واجهة برمجة تطبيقات الويب هذه.

طلب عنوان URL

منصب https://api.dotcom-monitor.com/config_api_v1/task/{task_id}

معلمات المسار

ميدان نوع مطلوب وصف
task_id

خيط

صحيح

 المعرف الفريد لمهمة المراقبة التي تريد تحريرها.

للاطلاع على معرف مهمة من داخل حساب dotcom-monitor الخاص بك، افتح الجهاز الهدف في قائمة “إدارة الأجهزة” لتحريره. في شريط عناوين المتصفح، سترى شيئا مثل:

https://user.dotcom-monitor.com/ClientID/DeviceEdit?pid=dc7f4ff2ca944dekjh1078b96707002&deviceId=63698&taskId=132834

معرف المهمة = 132834 هو معرف المهمة.

معلمات الاستعلام

ميدان نوع مطلوب/اختياري وصف
مهله

إنت32

اختياري

 يحتوي على مهلة تنفيذ المهمة بالمللي ثانية.
Device_Id

إنت32

مطلوب

 معرف الجهاز الفريد.

مثل:
"Device_Id": 8692
Task_Type_Id

إنت32

مطلوب

 نوع المهمة.
اسم

خيط

اختياري

 وصف المهمة.
تتطلب تكرارزيارة

منطقيه

اختياري

يحدد حالة علامة محاكاة الزائر المرتجع .

القيم الممكنة:

  • صحيح – يتم تنفيذ المراقبة لمحاكاة زائر متكرر لديه بالفعل عناصر من الصفحة المخزنة مؤقتا.
  • خطأ – يتم محاكاة زائر جديد لكل تشغيل.
WriteVideoOnEachMonitoring

منطقيه

اختياري

 يحدد حالة خيار تسجيل الفيديو في كل تشغيل .

القيم المحتملة:

  • صحيح – يتم إنشاء سجل فيديو لكل جلسة مراقبة.
  • خطأ – يسجل النظام مقطع فيديو في الجلسة الأولى من اليوم الذي يخطئ أو في الخطأ الأول الذي تم اكتشافه من موقع ما.
ديسابليتببروكسي

منطقيه

اختياري

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

منطقيه

اختياري

 يسمح بتعطيل ميزة تسجيل الفيديو.
تعطيللقطات الشاشة

منطقيه

اختياري

 يسمح بتعطيل ميزة لقطات الشاشة.
AbortOnError

منطقيه

اختياري

 يشير إلى ما إذا كان خيار إحباط البرنامج النصي عند الخطأ الأول نشطا.

القيم الممكنة:

  • صحيح – سيتم إيقاف تنفيذ البرنامج النصي عند أول خطأ في المراقبة.
  • خطأ – سيستمر تنفيذ البرنامج النصي حتى يتم الوصول إلى المهلة.
DNSResolveMode

منطقيه

اختياري

 القيم الممكنة:

  • الجهاز المخزن مؤقتا
  • غير مخبأة
  • TTL المخزن مؤقتا
  • خادم DNS خارجي

للحصول على شرح مفصل، راجع مقالة خيار وضع DNS .
DNSserverIP

خيط

0ptional

 الحقل الخاص بعنوان IP مخصص لخادم DNS. للحصول على شرح مفصل، راجع مقالة خيار وضع DNS .
Custom DNSHosts

خيط

اختياري

 يحتوي على قائمة عناوين IP – أزواج أسماء المضيف المستخدمة لإعداد تعيين عناوين IP لأسماء المضيفين.

نص الطلب

تقبل واجهة برمجة تطبيقات Dotcom-Monitor الملفات الثنائية التي تم تحميلها باستخدام نص الطلب. لتحميل برنامج نصي ES مع طلبك إلى Dotcom-Monitor:

  1. قم بإنشاء أو تحرير برنامج نصي EveryStep باستخدام أداة البرمجة النصية EveryStep.
  2. قم بتنزيل البرنامج النصي على جهاز الكمبيوتر الخاص بك واحفظه في ملف dmuv / dmes.
  3. في عميل API، حدد لإرسال ملف dmuv/dmes كملف ثنائي في نص الطلب. إذا كان عميل API الخاص بك لا يدعم الطريقة الثنائية ، فاستخدم أسلوبا بديلا.
طلب مثال
curl --location --request PUT "https://api.dotcom-monitor.com/config_api_v1/task/12365?Device_Id=16826&Task_Type_Id=21&Timeout=55000&Name=uploaded_dmes_script" ^
--header "Content-Type: application/octet-stream" ^
--header "Cookie: DANA-AUTH-API-COOKIE=7efad88951954e61a1235f43219882f34; DANA-AUTH-COOKIE=21c34cc69cdd4123448eaa5c519a824e" ^
--data "@/C:/Users/dm_admin/ES_Scripts/everystep-script.dmes"

تحميل البرنامج النصي ES كبيانات مشفرة Base64

إذا كان عميل واجهة برمجة التطبيقات الخاص بك لا يدعم الطريقة الثنائية ، فيمكنك تحميل البرنامج النصي ES الخاص بك إلى Dotcom-Monitor كمعلمة نص JSON بتنسيق Base64. لاحظ أنه في هذه الحالة ، يجب تمرير جميع معلمات الطلب في نص الطلب (وليس في الاستعلام).

طلب عنوان URL

منصب https://api.dotcom-monitor.com/config_api_v1/task/{task_id}

معلمات المسار

ميدان نوع مطلوب وصف
task_id

خيط

صحيح

 المعرف الفريد لمهمة المراقبة التي تريد تحريرها.

معلمات الرأس

Content-Type: application/json

مثال على جسم JSON

{ 
    "Device_Id": 3153, 
    "Task_Type_Id": 21, 
    "Name": "dotcom-monitor.com", 
    "Timeout": 1200, 
    "base64dmuv": "AAEAAAD/////AQAAAAAAAAAEAQAAAAxTeXN0ZW0uSW50MzIBAAAAB21fdmFsdWUACAIAAAALAAEAAAD/////AQAAAAAAAAAMAgAAAERfT1FMX0R5bmFtaWNfLCB.......1bHR1cmU9bmV1dHJh"
    
}

معلمات الجسم

يتم توفير معلمات JSON المطلوبة أدناه. لإضافة المزيد من المعلمات إلى النص الأساسي، يرجى الاطلاع على وصف الحقول في واجهة برمجة التطبيقات: نموذج JSON لمهمة UserView.

ميدان نوع مطلوب/اختياري وصف
قاعدة64دموف خيط مطلوب يحتوي على البرنامج النصي ES بتنسيق Base64.

يرجى الاطلاع على الإرشادات لتحويل البرنامج النصي EveryStep إلى Base64.
Device_Id

إنت32

مطلوب

 معرف الجهاز الفريد.

مثل:
"Device_Id": 8692
Task_Type_Id

إنت32

مطلوب

 نوع المهمة.

لتحويل البرنامج النصي إلى تنسيق Base64 ، ستحتاج إلى استيراد البرنامج النصي من الأداة إلى ملف * .dmuv (ES Desktop) أو * .dmes (ES Web) أولا. يرجى اتباع الخطوات التالية:

  1. قم بإنشاء أو تحرير برنامج نصي EveryStep باستخدام أداة البرمجة النصية EveryStep.
  2. قم بتنزيل البرنامج النصي على جهاز الكمبيوتر الخاص بك واحفظه في ملف dmuv / dmes.
  3. استخدم برنامج ترميز لتحويل ملف dmuv/dmes إلى تنسيق Base64.
  4. انسخ محتوى مشفرا إلى المعلمة base64dmuv لطلب JSON الخاص بك.

بدلا من ذلك ، إذا كنت تواجه أي مشكلة في تحويل ملف البرنامج النصي إلى Base64 ، فيمكنك تنزيل برنامج تشفير Base64 الخاص بنا هنا. بمجرد التنزيل ، استخدم برنامج التشفير لتحويل ملف ES كما هو موضح أدناه:

  1. افتح سطر الأوامر وقم بتوفير مسار إلى برنامج التشفير .exe ملف encoding_checker.exe.
  2. قم بتوفير المسار الكامل لملف dmuv/dmes الذي تم تنزيله كوسيطة (على سبيل المثال، “g:\Temp9\login_check.dmuv”).
  3. لحفظ برنامج نصي محول إلى ملف، قم بتوفير مسار إلى الملف.

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

مثال على الاستجابة
{
    "Success": true,
    "Result": "Task 12365 has been updated"
}