REST / MCP / SDK
תיעוד ה-API של UptimeScout
מצב השירות, אינדיקציות אזוריות והיסטוריה דרך REST, ערכות SDK ו־MCP. בנו לוחות מחוונים וספקו לעוזרי AI הקשר ברור לגבי זמינות.
התחלה מהירה
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. מכסת הבקשות מתאפסת בעת חידוש הרישיון או שינוי המסלול שלו, ולא בתחילת חודש קלנדרי. מסלולים שנתיים כוללים מכסה השווה ל-12 מכסות חודשיות, המאוגדת למאגר בקשות אחד לכל תקופת הרישיון. ההיסטוריה מצטברת ממועד תחילת איסוף הנתונים. במסלול Free אין חיוב חוזר.
תמחורחיבור לעוזר AI
הוסיפו את כתובת השרת לעוזר, בחרו 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.792274Z",
"region": "US",
"service": {
"age_seconds": 15,
"category": "it",
"description": "\u05e4\u05dc\u05d8\u05e4\u05d5\u05e8\u05de\u05d4 \u05dc\u05de\u05d0\u05d2\u05e8\u05d9 Git, \u05dc\u05e9\u05d9\u05ea\u05d5\u05e3 \u05e4\u05e2\u05d5\u05dc\u05d4 \u05d1\u05e4\u05d9\u05ea\u05d5\u05d7 \u05e7\u05d5\u05d3, \u05dc\u05e0\u05d9\u05d4\u05d5\u05dc \u05d1\u05e2\u05d9\u05d5\u05ea \u05d5\u05dc\u05d0\u05e1\u05e4\u05e7\u05ea \u05ea\u05d5\u05db\u05e0\u05d4.",
"description_language": "he",
"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"
}