REST / MCP / SDK
وثائق UptimeScout API
حالة الخدمات والإشارات الإقليمية وسجلها عبر REST وSDKs وMCP. أنشئ لوحات معلومات وامنح مساعدي الذكاء الاصطناعي سياقًا واضحًا عن التوافر.
البدء السريع
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
الطرق المتاحة
GET /v1/servicesابحث في دليل الخدمات وتنقّل بين صفحاته.GET /v1/statusاقرأ الحالة المحفوظة الحالية لخدمة واحدة.GET /v1/statusesاقرأ حالات عدة خدمات في طلب واحد.GET /v1/summaryلخّص الإشارات المرصودة لمنطقة أو لخدمات محددة.GET /v1/historyاقرأ الملاحظات المحفوظة بمرور الوقت، مع إمكانية التنقل بين الصفحات.GET /v1/statsاحسب نسب عينات الإشارات المحفوظة، لا وقت التشغيل المقاس.GET /v1/incidentsاعرض الخدمات ذات الإشارات المتزايدة؛ فهذه ليست حوادث عالمية مؤكدة.آلية عمل البيانات
يجمع UptimeScout الملاحظات الإقليمية في الخلفية. يتضمن كل رد وقت الملاحظة ومعلومات عن حداثة البيانات. وقد تختلف المؤشرات الخاصة بالخدمة نفسها من منطقة إلى أخرى.
تعني إشارة التشغيل أنه لم تُرصد اضطرابات متزايدة في العينة المتاحة. وتصف إشارات تدهور الأداء أو الانقطاع ظروفًا مرصودة، ولا تؤكد وقوع حادث عالمي. أما الملاحظات المفقودة أو القديمة فحالتها غير معروفة. لا تمثل نسب العينات وقت تشغيل مقاسًا ولا اتفاقية مستوى خدمة (SLA).
تُجمع البيانات باستمرار عبر المناطق. تحقّق من وقت رصد كل خدمة ومؤشر حداثة بياناتها لتقدير مدى راهنية حالتها.
تتحكم اللغة في طريقة عرض المعلومات، بينما تحدد منطقة الملاحظة البلد الذي تصفه البيانات. ويمكنك تغيير كلٍّ منهما بشكل مستقل. فتغيير لغة الصفحة لا يعني تلقائيًا أن الملاحظات واردة من بلد معين.
جميع الخدماتالترخيص وحدود الطلبات
استخدم مفتاح ترخيص Evelode كرمز Bearer. احتفظ به على خادمك، ولا تضعه في شيفرة المتصفح أو المستودعات العامة. لا يُخصم من الرصيد إلا مقابل طلبات البيانات المرخّصة الناجحة. يؤدي تجديد الترخيص أو تغيير خطته إلى بدء رصيد جديد؛ ولا يُعاد ضبط الرصيد مع بداية الأشهر التقويمية. توفر الخطط السنوية رصيدًا يعادل 12 ضعف رصيد الخطة الشهرية، مجمّعًا طوال مدة الترخيص السنوية.
تُدار المدفوعات والتجديدات وتغييرات الخطط وإدارة التراخيص عبر Evelode.com. يُعاد ضبط رصيد الطلبات عند تجديد الترخيص أو تغيير خطته، وليس في بداية الشهر الميلادي. تتضمن الخطط السنوية أرصدة اثني عشر شهرًا مجمّعة في رصيد واحد طوال مدة الترخيص. يتراكم السجل منذ بدء الجمع. لا تترتب على خطة Free رسوم متكررة.
الأسعاراربط مساعدًا ذكيًا
أضف عنوان الخادم إلى المساعد، واختر OAuth، ثم سجّل الدخول عبر Evelode أو أدخل مفتاح الترخيص في شاشة الربط. لا تحتاج إلى سرّ العميل.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
التعامل مع الردود
تحقّق من حالة HTTP قبل قراءة البيانات: تعني 400 أن المعلمات غير صالحة، وتشير 401 أو 403 إلى مشكلة في المصادقة أو الترخيص، وتعني 409 أن استحقاق الترخيص تغيّر أثناء الطلب، وتشير 429 إلى بلوغ حد الطلبات أو معدلها، وتعني 503 عدم التوفر مؤقتًا. التزم بمهل إعادة المحاولة وتجنّب تكرارها بفواصل قصيرة.
مثال من الملاحظات المحفوظة
{
"available_regions": [
"AE",
"AR",
"AT",
"AU",
"AZ",
"BD",
"BE",
"BG",
"BH",
"BR",
"CA",
"CH",
"CL",
"CO",
"CR",
"CZ",
"DE",
"DK",
"DO",
"DZ",
"EC",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"GT",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JO",
"JP",
"KE",
"KR",
"MA",
"MX",
"MY",
"NG",
"NL",
"NO",
"NZ",
"PA",
"PE",
"PH",
"PK",
"PL",
"PR",
"PT",
"PY",
"RO",
"RS",
"RU",
"SA",
"SE",
"SG",
"SK",
"TH",
"TN",
"TR",
"TW",
"UA",
"US",
"UY",
"VE",
"VN",
"ZA"
],
"data_type": "availability_observations",
"generated_at": "2026-11-18T18:55:17.644848Z",
"region": "US",
"service": {
"age_seconds": 15,
"category": "it",
"description": "\u0645\u0646\u0635\u0629 \u0644\u0645\u0633\u062a\u0648\u062f\u0639\u0627\u062a Git \u0648\u0627\u0644\u062a\u0639\u0627\u0648\u0646 \u0639\u0644\u0649 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0627\u062a \u0648\u0627\u0644\u0628\u0644\u0627\u063a\u0627\u062a \u0648\u062a\u0633\u0644\u064a\u0645 \u0627\u0644\u0628\u0631\u0627\u0645\u062c.",
"description_language": "ar",
"id": "github",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
"name": "GitHub",
"observed_at": "2026-11-18T18:55:01.987427Z",
"regions": [
"US"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "outage"
},
"stale_after_seconds": 600,
"status": "ok"
}