# وثائق UptimeScout API

حالة الخدمات والإشارات الإقليمية وسجلها عبر REST وSDKs وMCP. أنشئ لوحات معلومات وامنح مساعدي الذكاء الاصطناعي سياقًا واضحًا عن التوافر.

URL: https://uptimescout.com/ar/docs/

## REST

```sh
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 ضعف رصيد الخطة الشهرية، مجمّعًا طوال مدة الترخيص السنوية.

## اربط مساعدًا ذكيًا

صِل عميل MCP يدعم Streamable HTTP بنقطة النهاية أدناه، وأرسل مفتاح الترخيص في ترويسة Authorization. توفّر سبع أدوات للقراءة فقط حالات الخدمات والإشارات الإقليمية والسجل. وتسري حدود الترخيص نفسها.

https://mcp.uptimescout.com

## التعامل مع الردود

تحقّق من حالة HTTP قبل قراءة البيانات: تعني 400 أن المعلمات غير صالحة، وتشير 401 أو 403 إلى مشكلة في المصادقة أو الترخيص، وتعني 409 أن استحقاق الترخيص تغيّر أثناء الطلب، وتشير 429 إلى بلوغ حد الطلبات أو معدلها، وتعني 503 عدم التوفر مؤقتًا. التزم بمهل إعادة المحاولة وتجنّب تكرارها بفواصل قصيرة.

OpenAPI: https://uptimescout.com/openapi.json
