# ממשק ה-API של UptimeScout: זמינות שירותים לפי אזור עבור האפליקציות וה-AI שלכם

https://jsonscraper.com/he/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-he.webp)

כשפלטפורמה חיצונית מפסיקה להגיב, הבעיה הופכת במהירות לשלכם: האימות נכשל, האינטגרציה נתקעת והתור לפניות לתמיכה מתארך. ובכל זאת, אותו שירות עשוי להיראות אחרת למשתמשים במדינות שונות. במצב כזה, סטטוס כללי של «הכול עובד» אינו מספיק.



אנחנו משיקים את [ממשק ה-API של UptimeScout ב-jsonscraper](https://jsonscraper.com/he/services/uptimescout-api?region=RU). הוא מספק לאפליקציות ולעוזרי ה-AI שלכם אותות זמינות אזוריים של שירותים חיצוניים — עם היסטוריה, מועד התצפית וציון מפורש של עדכניות הנתונים. REST, MCP וערכות SDK לשש שפות כבר זמינים. אפשר להתחיל במסלול החינמי.

 

## בדקו שירות מנקודת מבט של מדינה מסוימת



לצוות תמיכה יש שאלה פשוטה וחשובה: מה קורה לשירות במקום שבו נמצא המשתמש? UptimeScout מאפשר לבחור מדינה, לקבל אות עדכני ולהשוות אותו לתצפיות מאזורים אחרים.



לדוגמה, תוכלו לבדוק את GitHub ברוסיה ובגרמניה, ואז לפתוח את ההיסטוריה עבור התקופה הזמינה. כך מתווסף הקשר ליומנים שלכם, והדבר עוזר לבחור את הצעד הבא בחקירה. בתשובת ה-API שנבדקה ב-19 בנובמבר 2026 היו זמינים 72 אזורים. בדקו את הכיסוי העדכני ב-`available_regions`: הכיסוי עשוי להשתנות בין שירותים.



כל תשובה כוללת את מועד התצפית `observed_at` ואת סימון הנתונים המיושנים `stale`. אפשר לבחור את שפת התיאור בנפרד מהמדינה: למשל, לקבל תצפיות מיפן עם תיאור ברוסית או באנגלית. בסך הכול נתמכות 20 שפות תיאור.



> אות אזורי עוזר לזהות בעיה. הוא אינו קובע את הגורם לה ואינו מאשר שמדובר בתקלה גלובלית. לצורך חקירה, השוו אותו לבדיקות שלכם ולסטטוס הרשמי של הספק; סטטיסטיקת התצפיות אינה מדידה של uptime או 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
   
   **השתמשו בתוצאה**
   
   בלוח מחוונים, בתמיכה או בעוזר AI.



עבור כמה תלות בשירותים חיצוניים, השתמשו בבקשת אצווה. להשוואת מדינות, שלחו בקשה נפרדת לכל אזור. ולפני שליחת התראה מדאיגה למשתמשים, אמתו את האות מול מקורות נוספים.

 

## 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/he/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, התקינו את לקוח ה-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` ללקוח AI תואם. ב-[הוראות MCP](https://mcp.uptimescout.com/connect?ui_locales=he) מוסבר כיצד לבצע אימות באמצעות Evelode או מפתח רישיון. זמין גם [המחבר הכללי של jsonscraper](https://jsonscraper.com/he/services/uptimescout-api#connect).



> «בדוק את GitHub ברוסיה ובגרמניה. ציין את מועד התצפית ואת עדכניות הנתונים עבור כל מדינה. אם האותות שונים, הסבר מה ידוע ואילו בדיקות כדאי לבצע בהמשך».



העוזר יקבל נתונים מובנים מה-API ויוכל להסביר את התוצאה בהקשר של המשימה שלכם. עם זאת, מגבלות העדכניות והכיסוי האזורי נשארות בתוקף.

 

## שלוש דרכים לחבר את אותם נתונים



בחרו בממשק המוכר לכם. REST מתאים לבקשות HTTP ישירות, SDK מתאים ליישום, ו־MCP מתאים לעוזר AI. האזור, עדכניות התצפית ומשמעות הסטטוסים נותרים זהים בכל המקרים.



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

**ממשק ה־API של UptimeScout**שירות · מדינה · מועד התצפית



- **REST**בקשות HTTP ישירות
- **SDK**לקוח מוכן ליישום
- **MCP**כלים לעוזר AI

 

## התחלה בחינם עם מגבלות ברורות



מסלול Free כולל **1,000 בקשות מוצלחות בתקופת הרישיון**, עד **60 בקשות בדקה**, עד **5 שירותים באצווה אחת** והיסטוריה של **7 ימים**. אפשר לנסות REST, ערכות SDK ו-MCP באמצעות רישיון אחד.



אצווה מוצלחת שנמצאת בתוך מגבלת המסלול צורכת בקשה אחת. כל עמוד נוסף של היסטוריה נספר כקריאה נפרדת. המכסה קשורה לתקופת הרישיון ומתאפסת עם חידוש הרישיון או שינוי המסלול, ולא בראשון לחודש. ההיסטוריה כוללת רק תקופות שבהן נאספו תצפיות בפועל.



זה מספיק כדי להכיר את ה-API ולבנות אבטיפוס. לצורך ניטור קבוע, התאימו את תדירות הבקשות למכסה; לעומסים גדולים יותר זמינים המסלולים Starter, Builder, Pro ו-Scale. התנאים העדכניים מפורסמים ב-[עמוד המסלולים](https://jsonscraper.com/he/services/uptimescout-api#pricing).

 

## התחילו בתלות אחת



בחרו שירות שחשוב למוצר שלכם ומדינה שבה נמצא קהל המשתמשים שלכם. הביטו במפה, שלחו את הבקשה הראשונה והעריכו כיצד ההקשר האזורי עוזר לצוות שלכם. לאחר מכן הוסיפו היסטוריה, שירותים תלויים נוספים או עוזר AI משלכם.



**[פתחו את ממשק ה-API של UptimeScout והתחילו בחינם →](https://jsonscraper.com/he/services/uptimescout-api?region=RU)**
