# واجهة UptimeScout API: توافر الخدمات حسب المنطقة لتطبيقاتك والذكاء الاصطناعي

https://jsonscraper.com/ar/blog/uptimescout-regional-api-launch

Author: Michael Johnson

Published: 2026-11-19T15:24:18+00:00

Updated: 2026-11-19T15:24:18+00:00

نطلق واجهة API على jsonscraper: ‏REST وMCP وست حزم SDK جاهزة. راقب التبعيات الخارجية من البلد الذي تختاره — وابدأ مجانًا.

![UptimeScout — مراقبة توافر الخدمات](https://jsonscraper.com/assets/img/uptimescout-launch/cover-v8-ar.webp)

عندما تتوقف منصة خارجية عن الاستجابة، تصبح المشكلة مشكلتك بسرعة: يتعذر إتمام المصادقة، ويتعطل التكامل، ويتزايد عدد طلبات الدعم. ومع ذلك، قد تبدو الخدمة نفسها مختلفة للمستخدمين في بلدان مختلفة. وفي هذه الحالة، لا تكفي حالة عامة تقول «كل شيء يعمل».



نطلق [UptimeScout API على jsonscraper](https://jsonscraper.com/ar/services/uptimescout-api?region=RU). تتيح لتطبيقاتك ومساعدي الذكاء الاصطناعي الوصول إلى مؤشرات توافر الخدمات الخارجية حسب المنطقة، مع سجل ووقت الرصد وبيان واضح لحداثة البيانات. تتوفر الآن واجهات REST وMCP وحزم SDK لست لغات. ويمكنك البدء بخطة مجانية.

 

## راقب الخدمة من البلد الذي تختاره



يهم فريق الدعم سؤال بسيط: ما حالة الخدمة في موقع المستخدم؟ تتيح لك UptimeScout اختيار بلد، والحصول على المؤشر الحالي، ومقارنته بعمليات الرصد في مناطق أخرى.



على سبيل المثال، يمكنك التحقق من GitHub في روسيا وألمانيا، ثم فتح السجل للفترة المتاحة. يضيف هذا سياقًا إلى سجلاتك الخاصة ويساعدك على اختيار الخطوة التالية في التحقيق. في استجابة API التي جرى التحقق منها في 19 نوفمبر 2026، كان هناك 72 منطقة متاحة. راجع التغطية الحالية في `available_regions`: فقد تختلف من خدمة إلى أخرى.



تتضمن كل استجابة وقت الرصد `observed_at` ومؤشر التقادم `stale`. ويُختار وصف اللغة بمعزل عن البلد: يمكنك الحصول على عمليات رصد لليابان مع وصف باللغة الروسية أو الإنجليزية. وتدعم الخدمة 20 لغة للوصف إجمالًا.



> يساعد المؤشر الإقليمي على ملاحظة المشكلة، لكنه لا يحدد سببها ولا يؤكد حدوث انقطاع عام. عند التحقيق، قارنه بفحوصاتك الخاصة وبصفحة الحالة الرسمية للمزود؛ فإحصاءات الرصد ليست قياسًا لزمن التشغيل أو لاتفاقية مستوى الخدمة (SLA).

 

## افتح خريطة عمليات الرصد



اختر بلدًا أو ابحث عن الخدمة المطلوبة. بدّل بين الكرة الأرضية والخريطة لرؤية الاختلافات الإقليمية ووقت أحدث عمليات الرصد.



[Interactive regional observations](https://jsonscraper.com/services/uptimescout-api#regions). Live observations are separate from the historical examples in this article.



تعرض الخريطة لقطة بيانات محفوظة، يجري تحديثها في الخلفية مرة واحدة تقريبًا كل دقيقة. ويظل وقت الرصد ظاهرًا: إذا لم تتوفر بيانات حديثة، فلا يمكن اعتبار الحالة مؤكدة.

 

## من المؤشر الخارجي إلى إجراء مفيد



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



![رسم توضيحي مفاهيمي: تتجمع عمليات الرصد الإقليمية في رد منظم لواجهة API](https://jsonscraper.com/assets/img/uptimescout-launch/regions-v2.webp)

السياق الإقليمي لتكاملاتك. رسم توضيحي مفاهيمي، وليس قياسات حقيقية.



1. 01
   
   **اختر السياق**
   
   الخدمة المطلوبة وبلد جمهورك.
2. 02
   
   **تحقق من الرصد**
   
   الحالة والوقت وحداثة البيانات في استجابة واحدة.
3. 03
   
   **استخدم النتيجة**
   
   في لوحة المعلومات أو الدعم أو مساعد الذكاء الاصطناعي.



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

 

## واجهة API واحدة لثلاث مهام



### اعثر على خدمة



`/v1/services` — البحث في الدليل. ابدأ به لاختيار التبعية المطلوبة.



### افهم الوضع الحالي



يعرض `/v1/status` مؤشر خدمة واحدة، ويعرض `/v1/statuses` مؤشرات عدة خدمات دفعة واحدة، بينما يجمع `/v1/summary` ملخصًا.



### راجع التغييرات



يوفر `/v1/history` السجل، ويقدم `/v1/stats` إحصاءات الرصد، ويعرض `/v1/incidents` أحدث المؤشرات المرتفعة للمشكلات.



تتوفر الطرق السبع كلها أيضًا عبر MCP، ومنها `uptimescout_status` و`uptimescout_history`. تجد المعلمات كاملة في [مواصفات OpenAPI](https://uptimescout.com/openapi.json).

 

## أرسل طلبك الأول في دقائق



اختر [الخطة المجانية](https://jsonscraper.com/ar/services/uptimescout-api#pricing)، واحصل على مفتاح الترخيص عبر Evelode، واحفظه على الخادم ضمن `UPTIMESCOUT_LICENSE_KEY`. يصلح المفتاح نفسه لواجهات REST وMCP وجميع حزم SDK الخاصة بـ UptimeScout.



```bash
curl --get 'https://api.uptimescout.com/v1/status' \
  --header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
  --data-urlencode 'service=github' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'lang=ru'
```



إذا كنت تستخدم Python، فثبّت العميل الجاهز من إصدار GitHub:



```bash
python -m pip install "git+https://github.com/jsonscraper/uptimescout-api-python.git@0.1.3"
```



```python
import os
from uptimescout import Client

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])
```



إلى جانب [Python](https://github.com/jsonscraper/uptimescout-api-python)، تتوفر حزم SDK لـ [Node.js](https://github.com/jsonscraper/uptimescout-api-node) و[PHP](https://github.com/jsonscraper/uptimescout-api-php) و[Go](https://github.com/jsonscraper/uptimescout-api-go) و[Java](https://github.com/jsonscraper/uptimescout-api-java) و[.NET](https://github.com/jsonscraper/uptimescout-api-dotnet). يحتوي كل مستودع على تعليمات وأمثلة للطلبات.



عند معالجة الاستجابة، ميّز بين حقلين: يصف `status` على المستوى الأعلى تنفيذ طلب API، بينما يشير `service.status` إلى حالة الخدمة المختارة. وعند عرض النتيجة، راعِ البلد ووقت الرصد و`stale`.

 

## ما الذي يتضمنه الرد؟



فيما يلي ردّ حقيقي مختصر من UptimeScout عن GitHub في روسيا، جرى الحصول عليه في 19 نوفمبر 2026. هذا مثال على بنية البيانات، وليس حالة الخدمة الحالية؛ وقد حُذفت حقول الترخيص واستهلاك الحصة.



GET /v1/statusJSON · RU



```json
{
  "status": "ok",
  "region": "RU",
  "service": {
    "id": "github",
    "name": "GitHub",
    "status": "operational",
    "stale": false,
    "observed_at": "2026-11-19T13:46:49.188257Z",
    "signal": "reported_availability",
    "scope": "regional"
  },
  "generated_at": "2026-11-19T13:48:48.782598Z",
  "stale_after_seconds": 600
}
```



**`service.status`**


إشارة حالة الخدمة المحددة؛ وهي هنا operational.



**`region`**


بلد الرصد، وليس لغة الرد.



**`observed_at`**


وقت الرصد نفسه وفق التوقيت العالمي المنسق (UTC).



**`stale`**


مؤشر يبيّن ما إذا كان الرصد قد أصبح قديماً.



يشير الحقل `generated_at` إلى وقت إنشاء الرد. وهو لا يحل محل `observed_at`: فقد تكون البيانات أقدم من الرد نفسه.

 

## واجهة API نفسها، في محادثة مع مساعد



إذا كنت تفضل البدء من دون كتابة شيفرة خاصة بك، فاربط `https://mcp.uptimescout.com` بعميل ذكاء اصطناعي متوافق. يشرح [دليل MCP](https://mcp.uptimescout.com/connect?ui_locales=ar) المصادقة عبر Evelode أو باستخدام مفتاح ترخيص. يتوفر أيضًا [موصل jsonscraper العام](https://jsonscraper.com/ar/services/uptimescout-api#connect).



> «تحقق من GitHub في روسيا وألمانيا. اذكر وقت الرصد وحداثة البيانات لكل بلد. وإذا اختلفت المؤشرات، فاشرح ما هو معروف وما الفحوصات التي يجدر إجراؤها بعد ذلك».



سيحصل المساعد على بيانات API منظمة، ويمكنه شرح النتيجة في سياق مهمتك. وتظل قيود حداثة البيانات والتغطية الإقليمية قائمة.

 

## ثلاث طرق لربط البيانات نفسها



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



![UptimeScout](https://jsonscraper.com/assets/img/uptimescout-launch/uptimescout-logo.svg)

**واجهة UptimeScout البرمجية**الخدمة · البلد · وقت الرصد



- **REST**طلبات HTTP مباشرة
- **SDK**عميل جاهز للتطبيق
- **MCP**أدوات مساعد الذكاء الاصطناعي

 

## ابدأ مجانًا بحدود واضحة



تتيح خطة Free **1,000 طلب ناجح خلال فترة الترخيص**، وحتى **60 طلبًا في الدقيقة**، وما يصل إلى **5 خدمات في طلب مجمع واحد**، وسجلًا لمدة **7 أيام**. يمكنك تجربة REST وحزم SDK وMCP باستخدام ترخيص واحد.



يستهلك الطلب المجمع الناجح، ما دام ضمن حدود الخطة، طلبًا واحدًا. وتُحتسب كل صفحة تالية من السجل استدعاءً مستقلًا. ترتبط الحصة بفترة الترخيص وتُعاد عند تجديده أو تغيير الخطة، لا في اليوم الأول من الشهر. ولا يتضمن السجل إلا الفترات التي جُمعت فيها عمليات الرصد بالفعل.



يكفي ذلك للتعرف على API وإنشاء نموذج أولي. للمراقبة المستمرة، وازن وتيرة الطلبات مع الحصة؛ ولأحجام الاستخدام الأكبر، تتوفر خطط Starter وBuilder وPro وScale. الشروط الحالية منشورة على [صفحة الخطط](https://jsonscraper.com/ar/services/uptimescout-api#pricing).

 

## ابدأ بتبعية واحدة



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



**[افتح UptimeScout API وابدأ مجانًا ←](https://jsonscraper.com/ar/services/uptimescout-api?region=RU)**
