כשפלטפורמה חיצונית מפסיקה להגיב, הבעיה הופכת במהירות לשלכם: האימות נכשל, האינטגרציה נתקעת והתור לפניות לתמיכה מתארך. ובכל זאת, אותו שירות עשוי להיראות אחרת למשתמשים במדינות שונות. במצב כזה, סטטוס כללי של «הכול עובד» אינו מספיק.
אנחנו משיקים את ממשק ה-API של UptimeScout ב-jsonscraper. הוא מספק לאפליקציות ולעוזרי ה-AI שלכם אותות זמינות אזוריים של שירותים חיצוניים — עם היסטוריה, מועד התצפית וציון מפורש של עדכניות הנתונים. REST, MCP וערכות SDK לשש שפות כבר זמינים. אפשר להתחיל במסלול החינמי.
בדקו שירות מנקודת מבט של מדינה מסוימת
לצוות תמיכה יש שאלה פשוטה וחשובה: מה קורה לשירות במקום שבו נמצא המשתמש? UptimeScout מאפשר לבחור מדינה, לקבל אות עדכני ולהשוות אותו לתצפיות מאזורים אחרים.
לדוגמה, תוכלו לבדוק את GitHub ברוסיה ובגרמניה, ואז לפתוח את ההיסטוריה עבור התקופה הזמינה. כך מתווסף הקשר ליומנים שלכם, והדבר עוזר לבחור את הצעד הבא בחקירה. בתשובת ה-API שנבדקה ב-19 בנובמבר 2026 היו זמינים 72 אזורים. בדקו את הכיסוי העדכני ב-available_regions: הכיסוי עשוי להשתנות בין שירותים.
כל תשובה כוללת את מועד התצפית observed_at ואת סימון הנתונים המיושנים stale. אפשר לבחור את שפת התיאור בנפרד מהמדינה: למשל, לקבל תצפיות מיפן עם תיאור ברוסית או באנגלית. בסך הכול נתמכות 20 שפות תיאור.
אות אזורי עוזר לזהות בעיה. הוא אינו קובע את הגורם לה ואינו מאשר שמדובר בתקלה גלובלית. לצורך חקירה, השוו אותו לבדיקות שלכם ולסטטוס הרשמי של הספק; סטטיסטיקת התצפיות אינה מדידה של uptime או SLA.
פתחו את מפת התצפיות
בחרו מדינה או חפשו את השירות הרצוי. עברו בין הגלובוס למפה כדי לראות הבדלים אזוריים ואת מועד התצפיות האחרונות.
המפה מציגה תמונת מצב שמורה של הנתונים, המתעדכנת ברקע בערך פעם בדקה. מועד התצפית נשאר גלוי: אם אין נתונים עדכניים, אי אפשר לראות במצב אישור מאומת.
מאות חיצוני לפעולה מועילה
שלבו את UptimeScout בתהליך שכבר קיים אצל הצוות שלכם. בלוח מחוונים הוא יספק הקשר על תלות בשירותים חיצוניים. בתמיכה הוא יעזור לבדוק דיווח ממדינה מסוימת. באוטומציה הוא יוכל לשמש מקור נתונים לדוח או להתראה משלכם.

- בחרו הקשר
השירות הדרוש והמדינה שבה נמצא קהל המשתמשים שלכם.
- בדקו את התצפית
הסטטוס, המועד ועדכניות הנתונים בתשובה אחת.
- השתמשו בתוצאה
בלוח מחוונים, בתמיכה או בעוזר AI.
עבור כמה תלות בשירותים חיצוניים, השתמשו בבקשת אצווה. להשוואת מדינות, שלחו בקשה נפרדת לכל אזור. ולפני שליחת התראה מדאיגה למשתמשים, אמתו את האות מול מקורות נוספים.
API אחד לשלוש משימות
מצאו שירות
/v1/services — חיפוש בקטלוג. התחילו כאן כדי לבחור את השירות התלוי הרצוי.
הבינו את המצב הנוכחי
/v1/status מחזיר אות עבור שירות אחד, /v1/statuses עבור כמה שירותים בבת אחת, ו-/v1/summary מציג סיכום.
בדקו שינויים
/v1/history מציג היסטוריה, /v1/stats מציג סטטיסטיקת תצפיות, ו-/v1/incidents מציג אותות עדכניים ומוגברים לבעיות.
כל שבעת המתודות זמינים גם דרך MCP: למשל, uptimescout_status ו-uptimescout_history. הפרמטרים המלאים מופיעים ב-מפרט OpenAPI.
הבקשה הראשונה שלכם בתוך דקות
בחרו ב-מסלול החינמי, קבלו מפתח רישיון דרך Evelode ושמרו אותו בשרת שלכם במשתנה UPTIMESCOUT_LICENSE_KEY. מפתח אחד מתאים ל-REST, ל-MCP ולכל ערכות ה-SDK של UptimeScout.
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:
python -m pip install "git+https://github.com/jsonscraper/[email protected]"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, זמינות ערכות SDK עבור Node.js, PHP, Go, Java ו-.NET. בכל מאגר יש הוראות ודוגמאות לבקשות.
בעת עיבוד התשובה, הבחינו בין שני שדות: status ברמה העליונה מתאר את ביצוע הבקשה ל-API, ואילו service.status הוא האות של השירות שנבחר. כשמציגים תוצאה, התחשבו במדינה, במועד התצפית וב-stale.
מה מתקבל בתשובה
להלן תשובה אמיתית מקוצרת של UptimeScout עבור GitHub ברוסיה, שהתקבלה ב־19 בנובמבר 2026. זו דוגמה למבנה הנתונים, ולא הסטטוס הנוכחי של השירות; שדות הרישיון וצריכת המכסה הושמטו.
{
"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 מוסבר כיצד לבצע אימות באמצעות Evelode או מפתח רישיון. זמין גם המחבר הכללי של jsonscraper.
«בדוק את GitHub ברוסיה ובגרמניה. ציין את מועד התצפית ואת עדכניות הנתונים עבור כל מדינה. אם האותות שונים, הסבר מה ידוע ואילו בדיקות כדאי לבצע בהמשך».
העוזר יקבל נתונים מובנים מה-API ויוכל להסביר את התוצאה בהקשר של המשימה שלכם. עם זאת, מגבלות העדכניות והכיסוי האזורי נשארות בתוקף.
שלוש דרכים לחבר את אותם נתונים
בחרו בממשק המוכר לכם. REST מתאים לבקשות HTTP ישירות, SDK מתאים ליישום, ו־MCP מתאים לעוזר AI. האזור, עדכניות התצפית ומשמעות הסטטוסים נותרים זהים בכל המקרים.
- RESTבקשות HTTP ישירות
- SDKלקוח מוכן ליישום
- MCPכלים לעוזר AI
התחלה בחינם עם מגבלות ברורות
מסלול Free כולל 1,000 בקשות מוצלחות בתקופת הרישיון, עד 60 בקשות בדקה, עד 5 שירותים באצווה אחת והיסטוריה של 7 ימים. אפשר לנסות REST, ערכות SDK ו-MCP באמצעות רישיון אחד.
אצווה מוצלחת שנמצאת בתוך מגבלת המסלול צורכת בקשה אחת. כל עמוד נוסף של היסטוריה נספר כקריאה נפרדת. המכסה קשורה לתקופת הרישיון ומתאפסת עם חידוש הרישיון או שינוי המסלול, ולא בראשון לחודש. ההיסטוריה כוללת רק תקופות שבהן נאספו תצפיות בפועל.
זה מספיק כדי להכיר את ה-API ולבנות אבטיפוס. לצורך ניטור קבוע, התאימו את תדירות הבקשות למכסה; לעומסים גדולים יותר זמינים המסלולים Starter, Builder, Pro ו-Scale. התנאים העדכניים מפורסמים ב-עמוד המסלולים.
התחילו בתלות אחת
בחרו שירות שחשוב למוצר שלכם ומדינה שבה נמצא קהל המשתמשים שלכם. הביטו במפה, שלחו את הבקשה הראשונה והעריכו כיצד ההקשר האזורי עוזר לצוות שלכם. לאחר מכן הוסיפו היסטוריה, שירותים תלויים נוספים או עוזר AI משלכם.
