# 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.

URL: https://uptimescout.com/tr/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"
```

## Kullanılabilir yöntemler

- `GET /v1/services`: Hizmet kataloğunda arama yapın ve sayfalar arasında gezinin.

- `GET /v1/status`: Tek bir hizmetin kaydedilmiş güncel durumunu okuyun.

- `GET /v1/statuses`: Tek bir istekte birden fazla hizmetin durumunu okuyun.

- `GET /v1/summary`: Bir bölge veya seçili hizmetler için gözlemlenen sinyalleri özetleyin.

- `GET /v1/history`: Sayfalar 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/incidents`: Yü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.

## Lisans 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.

## Bir yapay zekâ asistanı bağlayın

Aşağıdaki uç noktaya Streamable HTTP MCP istemcisiyle bağlanın ve lisans anahtarınızı Authorization başlığında iletin. Yalnızca okuma yapan yedi araç, hizmet durumlarını, bölgesel sinyalleri ve geçmişi sunar. Aynı lisans sınırları geçerlidir.

https://mcp.uptimescout.com

## 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.

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