# UptimeScout ile hizmet kullanılabilirliği API’si nasıl entegre edilir?



URL: https://uptimescout.com/tr/blog/availability-api-integration/



Her yanıtı renkli bir noktaya indirgemek yerine zaman damgalarını ve belirsizliği görünür tutan bir kullanılabilirlik paneli oluşturun.



## Sorgulama yapmadan önce hizmet kimliklerini bulun



UptimeScout’un kullandığı tanımlayıcıyı bulmak için hizmetler uç noktasıyla başlayın. Kullanıcıların bildiği marka adı, API tanımlayıcısıyla her zaman aynı olmayabilir. Durum ve geçmiş isteklerinin aynı hizmete yönelmesi için kimliği ve bölgeyi uygulama yapılandırmanızda saklayın.

Evelode üzerinden uygun bir lisans edinin ve bunu sunucu tarafında bir gizli bilgi olarak veya ortam değişkeninde saklayın. Ücretli anahtarı tarayıcı JavaScript’ine, herkese açık bir depoya, ekran görüntüsüne veya URL’ye eklemeyin.



## Kimliği doğrulanmış bir durum isteği gönderin



Örneği çalıştırmadan önce kendi ortamınızda EVELODE_LICENSE_KEY değerini ayarlayın. Bu örnek, GitHub için US gözlemlerini ister; bu bir istek şablonudur, GitHub’ın mevcut durumuyla ilgili bir iddia değildir.



```sh

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

```



## Yanıtı görüntülemeden önce yorumlayın



Taşıma katmanında başarılı bir yanıt alınmasıyla hizmet kullanılabilirlik sinyali farklı katmanlardır. Önce HTTP durumunu ve yanıt zarfını doğrulayın. Ardından service.status, service.observed_at ve service.stale değerlerini inceleyin. unknown ve stale değerlerini gizlemek veya sessizce operational kabul etmek yerine görünür tutun.

Bölgeyi gözlem zamanıyla birlikte saklayın. Arayüzünüz dakikada bir yenileniyorsa gözlem zamanını, uygulamanızın yanıtı aldığı zamandan ayrı olarak belirtin. Güncel bir HTTP yanıtı, daha eski bir gözlemi açıklıyor olabilir.



## İstek hacmini planlayın ve limitleri yönetin



İş akışınıza uygunsa toplu durum uç noktasını kullanın ve seçtiğiniz planın en büyük toplu istek boyutunu kontrol edin. İstek hakkı ile dakikadaki istek sayısı farklı limitlerdir. REST, SDK ve MCP erişimi aynı lisanslı istek hesabını paylaşır.

HTTP 429 yanıtında Retry-After değerine uyun ve hemen art arda çok sayıda istek göndermeyin. Geçici hatalarda artan gecikmeyle sınırlı sayıda yeniden deneme yapın; kimlik doğrulama veya geçersiz parametre hatalarını durmadan yeniden denemeyin. Yenileme ve plan değişiklikleri lisanslı isteği günceller; takvim ayının ilk günü sıfırlama yapılmaz.



## Yayına almadan önce belirsiz durumları test edin



Bilinen bir hizmeti, bilinmeyen bir kimliği, eksik anahtarı, geçersiz parametreleri ve güncelliğini yitirmiş ya da eksik bir gözlemi test edin. Arayüzünüzün bu durumlarda yararlı mesajlar verdiğini doğrulayın. Kimlik bilgileri veya hesap bilgileri içeren tam tanılama sonuçlarını herkese açık kayıtlarda tutmayın.

API belgelerinde yedi genel yöntemin tümü ve OpenAPI şeması bulunur. jsonscraper, Python, Node.js, PHP, Go, Java ve .NET SDK’larına bağlantı verir. Bir istemci kitaplığı taşıma katmanını kolaylaştırır; ancak uygulamanızın belirsizliği yorumlamaya yönelik bir politikaya yine de ihtiyacı vardır.



## Kaynaklar

https://uptimescout.com/tr/docs/

https://uptimescout.com/tr/methodology/

https://uptimescout.com/tr/contacts/
