REST / MCP / SDK
UptimeScout API belgeleri
REST, SDK’lar ve MCP üzerinden hizmet durumu, bölgesel sinyaller ve geçmiş. Kontrol panoları oluşturun ve yapay zekâ asistanlarına kullanılabilirlik hakkında net bilgi sunun.
Hızlı başlangıç
curl -G https://api.uptimescout.com/v1/status \ --data-urlencode "service=github" \ --data-urlencode "region=US" \ -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
Kullanılabilir yöntemler
GET /v1/servicesHizmet kataloğunda arama yapın ve sayfalar arasında gezinin.GET /v1/statusTek bir hizmetin kaydedilmiş güncel durumunu okuyun.GET /v1/statusesTek bir istekte birden fazla hizmetin durumunu okuyun.GET /v1/summaryBir bölge veya seçili hizmetler için gözlemlenen sinyalleri özetleyin.GET /v1/historySayfalar arasında gezinerek kaydedilmiş gözlemleri zaman içinde okuyun.GET /v1/statsÖlçülmüş çalışma süresi yerine, kaydedilmiş sinyal örneklerinin oranlarını hesaplayın.GET /v1/incidentsYüksek düzeyli sinyalleri olan hizmetleri listeleyin; bunlar doğrulanmış küresel olaylar değildir.Veriler nasıl çalışır?
UptimeScout, bölgesel gözlemleri arka planda saklar. Her yanıt, gözlem zamanını ve verinin güncelliğine ilişkin bilgileri içerir. Aynı hizmetin farklı bölgelerde farklı sinyalleri olabilir.
Normal çalışma sinyali, kaydedilen örnekte yüksek düzeyli bir aksaklık gözlemlenmediği anlamına gelir. Yüksek düzeyli aksaklık veya kesinti sinyalleri gözlemlenen koşulları belirtir; doğrulanmış küresel bir olayı değil. Eksik veya güncelliğini yitirmiş gözlemler bilinmiyor olarak değerlendirilir. Örneklem oranları, ölçülmüş çalışma süresi yüzdeleri veya SLA değildir.
Arayüz dakikada bir yenilenir. Durumun ne kadar güncel olduğunu değerlendirmek için her hizmetin gözlem zamanını ve güncellik bilgisini kontrol edin.
Dil, bilgilerin nasıl sunulacağını belirler; gözlem bölgesi ise verilerin hangi ülkeyi kapsadığını belirler. Bu ayarları birbirinden bağımsız olarak değiştirebilirsiniz. Sayfanın çevrilmiş olması, gözlemlerin belirli bir ülkeden alındığı anlamına gelmez.
Tüm hizmetlerLisans ve istek sınırları
Evelode lisans anahtarınızı Bearer token olarak kullanın. Anahtarı sunucunuzda saklayın; tarayıcı koduna veya herkese açık depolara koymayın. Kullanım hakkından yalnızca lisanslı veri istekleri başarılı olduğunda düşülür. Lisansı yenilemek veya planını değiştirmek yeni bir kullanım hakkı başlatır; takvim ayları bu hakkı sıfırlamaz. Yıllık planlar, yıllık lisans süresinin tamamı için tek bir istek havuzu sunar.
Ödemeler, yenilemeler, plan değişiklikleri ve lisans yönetimi Evelode.com üzerinden yapılır. İstek kotası, lisans yenilendiğinde veya planı değiştirildiğinde sıfırlanır. Takvim ayının başında sıfırlanmaz. Yıllık planlarda, lisans süresinin tamamında kullanılabilen tek bir istek havuzunda on iki aylık kota bulunur. Geçmiş veriler, koleksiyon başlatıldığından itibaren birikir. Ücretsiz plan için yinelenen bir ücret alınmaz.
FiyatlandırmaBir yapay zekâ asistanı bağlayın
Sunucu adresini asistanınıza ekleyin, OAuth’u seçin ve Evelode ile giriş yapın veya bağlantı ekranına lisans anahtarınızı girin. İstemci sırrı gerekmez.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
Yanıtları işleme
Verileri okumadan önce HTTP durum kodunu kontrol edin: 400 geçersiz parametreleri, 401 veya 403 kimlik doğrulama ya da lisans sorununu, 409 istek sırasında lisans hakkının değiştiğini, 429 istek veya hız sınırını, 503 ise geçici kullanılamazlığı belirtir. Yeniden deneme gecikmelerine uyun ve arka arkaya sık aralıklarla yeniden denemekten kaçının.
Kaydedilmiş gözlemlerden örnek
{
"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:16.157173Z",
"region": "US",
"service": {
"age_seconds": 14,
"category": "it",
"description": "Git depolar\u0131, kod \u00fczerinde i\u015f birli\u011fi, sorun takibi ve yaz\u0131l\u0131m da\u011f\u0131t\u0131m\u0131 i\u00e7in platform.",
"description_language": "tr",
"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"
}