Mini ders · Türkçe

Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?

Hazır depo sorgulama sayfasını kullanın, asistanla faydalı bir sonuç ekleyin; normal, bulunamayan ve hizmete ulaşılamayan yanıtları kontrol edin.

Etkileşimli derse başlaDers notlarını oku

Bu ders kimler için?

Web sitesinde başka hizmetten güncel bilgi göstermek isteyenler için. Tarayıcı kodunu verilen sayfa ve kodlama asistanı üstlenir; siz sonuca odaklanabilirsiniz.

Başlamadan önce

Verilen atölye, internet erişimi ve kodlama asistanınızın başlatabileceği yerel HTTP önizlemesi. Örnek, özel belirteç olmadan herkese açık GitHub depolarını okur; hizmet kullanılabilirliği/istek sınırları yine geçerlidir.

Tahmini süre: 14–26 dk

Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Oturum açmadan yapılan GitHub istekleri IP adresine bağlı ortak kotayı kullanır; tekrar tekrar denemek bu sınıra ulaşabilir.

Neler öğreneceksin?

  • Gerçek, herkese açık bir depoyu sorgulayın.
  • Kodlama asistanıyla faydalı bir ek sonuç gösterin.
  • Eşleşen depo bulunmamasını hizmete ulaşılamamasından ayırın.

Uygulama dosyaları

Adım 1

Hazır sorgulamayı açın

Sayfaya sabit sayı yazmak yerine hizmetten değer isteyin.

Sağlanan public klasörünü yerel bir web adresinde HTTP üzerinden açmasını asistanınızdan isteyin. Başlangıçtaki octocat / Hello-World örneğini kullanın ve sorgulama düğmesine basın.

Dönen depo kimliğini ve sayıyı o andaki hizmet sonucuyla karşılaştırın. Eski sayıyı güncelmiş gibi koda sabitlemeyin.

Somut bir örnek

Sayfa metnine kaydedilen yıldız sayısı, depo değiştiğinde değişemez.

Verilen herkese açık depo sorgulama sayfasını yerel HTTP üzerinden başlat. Mevcut güvenli metin gösterimini koru ve tarayıcı dosyalarına özel belirteç ekleme. Gerçek depo, bulunmayan depo ve başarısız hizmet isteğini sınamama yardım et. Sonra belgelenmiş açık öğe sayısını ekle ve API yanıtıyla karşılaştırmama yardım et. Kod değişikliklerini benim için yap.

GitHub: bir deponun bilgilerini alma

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Başka bir hizmetin verisini gösterin

GitHub’dan herkese açık bir deponun adını, açıklamasını ve yıldız sayısını alın.

API, yazılımların belirli bir biçimde veri veya işlem isteyebilmesini sağlar. Burada siteniz GitHub’dan bir depoyu ister ve HTML sayfası yerine JSON verisi alır.

İstekleri nasıl işleyeceğinizi kimlik doğrulamayla başlamadan öğrenmek için herkese açık bir okuma kullanıyoruz. Sonuç iki istek arasında değişebilir; o an gördüğünüz veridir, koda sabit yazacağınız değişmez bir sayı değildir.

Çözülmüş örnek

Depo sahibi octocat ve depo adı Hello-World olduğunda api.github.com üzerindeki istek yolu /repos/octocat/Hello-World olur. Sayfa yanıttaki full_name ve stargazers_count alanlarını gösterir.

GitHub: bir deponun bilgilerini alma

Extra implementation exercise

Yıldız sayısını HTML’ye kopyalamakla düğmeye basıldığında GitHub’dan almak arasında ne fark var?

Çözülmüş örneği göster

HTML’ye kopyalanan değer, dosya düzenlenene kadar eski kalır. fetch, o anda hizmetten güncel yanıtı ister. Ancak ağ veya hizmet yanıt vermeyebileceği için bekleme ve hata durumlarını da ele almak gerekir.

  • Değerin ne zaman alındığını açıklar.
  • Dış hizmete yapılan isteğin başarısız olabileceğini hesaba katar.

Adım 2

Başarılı bir yanıtı kontrol edin

Kaynakla karşılaştırabileceğiniz bir gözlem kullanın.

Asistanınızdan test deponuzun eşleşen herkese açık API yanıtını göstermesini isteyin; sayfanın hedeflenen değerleri gösterdiğini doğrulayın. Testi herkese açık ve hassas olmayan verilerle tutun.

Hata döndüren istek normal sonuç sayılmamalıdır. Görünür sonucu değerlendirmek için istek/hata kodunu yazmanız gerekmez.

Somut bir örnek

Örnek yanıt değerleri: full_name = practice/example ve stargazers_count = 12, görünürde practice/example depo adına ve 12 stars bilgisine dönüşmeli. Bunlar eşlemeyi anlamak için hayali değerler; sağlanan GitHub örneğinin güncel sayısı değil.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Bir istek hazırlayıp yanıtını kontrol edin

Kullanıcının yazdığı değerleri URL’ye uygun biçime dönüştürün ve yanıtı kullanmadan önce inceleyin.

public/app.js dosyasını okuyun ve verilen sayfayı HTTP üzerinden çalıştırın. encodeURIComponent, depo sahibi ile depo adının kendi yol parçalarında kalmasını sağlar. İsteğin gideceği sunucu sabittir; ziyaretçi istediği herhangi bir API adresini veremez.

fetch, 404 gibi HTTP hatalarında da tamamlanmış bir yanıt döndürür; yalnızca await ile beklemek yeterli değildir. response.ok ile ilgili durum kodlarını kontrol edin, JSON’u okuyun ve gösterilecek alanları doğrulayın. textContent, dışarıdan gelen metni HTML olarak değil metin olarak gösterir.

Aşağıdaki kısa kod genel HTTP kontrolünü anlatır. Tam app.js önce 404 ile erişim/kota sınırlaması yanıtlarını ayrı işler; ardından diğer başarısız durumları kontrol eder, JSON’u okur ve alanları doğrular. Yeni bir alan gösterirken bu sırayı koruyun.

Çözülmüş örnek

Açıklamadaki küçüktür ve büyüktür işaretleri, sayfanın HTML’sine dönüşmeden metin olarak görünmelidir. 404 durumunda boş bir başarı kartı yerine deponun bulunamadığını veya herkese açık olmadığını belirten mesaj gösterilmelidir.

if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;

Extra implementation exercise

Neden yalnızca try/catch kullanmak başarısız HTTP yanıtlarının hepsini yakalamaz?

Çözülmüş örneği göster

HTTP hatası da normal bir Response nesnesi oluşturabilir. Yanıt gövdesini istenen depo gibi kullanmadan önce status/ok kontrolü yapın ve hatayı fırlatın veya uygun şekilde işleyin.

  • fetch’in 404 ve 500 durumlarında da normal yanıt döndürebildiğini bilir.
  • Başarılı veri göstermeden önce durum kodunu kontrol eder.

Adım 3

Bulunamama ve hizmete ulaşılamama durumlarını deneyin

Farklı hataları anlaşılır tutun.

Var olmayan bir depo adı deneyin. Asistanınızla yerel alıştırma sayfasında engellenen/başarısız isteği de sınayın. Yazılan sorguyu düzeltme veya yeniden deneme için koruyun.

Sayfa, bulunmayan depoyu geçici hizmet hatasından ayırmalıdır. İstek sınırını aşmak için tarayıcıya özel belirteç eklemeyin.

Somut bir örnek

“Depo bulunamadı” ve “Hizmete ulaşılamıyor; yeniden deneyin” ziyaretçiye farklı sonraki adımlar söyler.

GitHub: REST API istek sınırları

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Farklı hataları birbirinden ayırın

Depo bulunamaması, ağ olmaması ve kotanın tükenmesi aynı sorun değildir.

Gerçek bir herkese açık depoyu, açıkça var olmayan bir adı ve tarayıcının çevrimdışı modunu deneyin. Arayüz yeni isteğe başlamadan eski sonucu temizler, aynı anda tekrar göndermeyi engeller ve sonunda düğmeyi yeniden açar.

GitHub, IP sınırı nedeniyle oturum açılmadan yapılan istekleri reddedebilir. Çözüm olarak tarayıcıya özel bir token koymayın. Düzenli ve kimlik doğrulamalı kullanım gerekiyorsa bu kimlik bilgisini denetlediğiniz sunucu yolunda kullanın ve uygun olduğunda veriyi önbelleğe alın.

Çözülmüş örnek

“Not found” (bulunamadı) altında eski başarı kartı durursa ziyaretçi eski sayıları yeni sorgunun sonucu sanabilir. Eski sonucu temizlemek, şu anki isteğin durumunu açık hale getirir.

GitHub: REST API istek sınırları

Extra implementation exercise

Birçok denemeden sonra sorgu başarısız oluyor. Arayüz deponun sıfır yıldızı olduğunu mu söylemeli?

Çözülmüş örneği göster

Hayır. Sıfır, gerçek bir veri değeridir. Verinin alınamadığını veya erişimin sınırlandığını söyleyip durumu inceleyin. Başarılı yanıt gelene kadar yıldız sayısı bilinmiyor.

  • Alınamayan veriyi sıfıra dönüştürmez.
  • İstek durumunu ve kota sınırına işaret eden bilgileri kontrol eder.

Adım 4

Faydalı bir sonuç ekleyin

Yeni bilgiyi tarif edin; bağlantısını asistan kursun.

Asistandan mevcut sonucun yanına open_issues_count yanıt alanını ekleyip open issues and pull requests diye etiketlemesini isteyin. GitHub’ın bu toplamı iki türü de kapsar; yalnızca hata sayısı diye yeniden adlandırılmamalı. Kendi sürümünüzü denedikten sonra sağlanan referansı kullanın.

Görünen değeri gerçek yanıtla karşılaştırın; sonra başarılı, bulunamayan ve kullanılamayan durumları tekrarlayın. Anlamını ve gözlenen durumları siz değerlendirirsiniz; tarayıcı kodunu asistan halleder.

Somut bir örnek

Hayali open_issues_count değeri 5, iki açık issue ve üç açık pull request anlamına gelebilir. “5 hata” etiketi, alanın doğrulamadığı bir şeyi iddia ederdi.

Bu adımda kullanılan dosyalar

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ödeviniz: depodan bir yararlı bilgi daha gösterin

Açık kayıtların sayısını ekleyin; gerçek veriyle hata durumunu birbirine karıştırmayın.

open_issues_count değerinin sonlu bir sayı olduğunu doğruladıktan sonra gösterin. GitHub’ın belgelerine göre bu sayı, issue kayıtlarıyla birlikte pull request denilen kod birleştirme taleplerini de içerir. Yalnızca hata bildirimlerinin kesin sayısıymış gibi adlandırmayın.

Başarılı sorguyu, bulunamayan depoyu ve çevrimdışı denemeyi kaydedin. İstek sürerken ve her sonuçtan sonra ziyaretçinin ne gördüğünü de yazın.

Çözülmüş örnek

“Open issues and pull requests” (açık kayıtlar ve kod birleştirme talepleri) yazısı, “Bugs” (hatalar) yazısından daha doğru bir açıklamadır.

Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.

Extra implementation exercise

Belgelenen açık kayıt sayısını sonuca ekleyin ve üç durumu da gösterin.

Çözülmüş örneği göster

Başarılı durum kontrolünden sonra doğrulanan alanlara open_issues_count ekleyin. Sonlu sayı isteyin ve 'Open issues and pull requests' etiketiyle gösterin; GitHub alanı ikisini de içerir. Tam referans betiği textContent kullanımını, bekleme ve hata durumlarını korur.

Örnek test verisi: full_name='sample/site', stargazers_count=3, open_issues_count=2 olduğunda 'sample/site — 3 stars — 2 open issues and pull requests' görünür. Yani üç yıldız ve iki açık kayıt/talep vardır; iki öğenin de yazılım hatası olduğu iddia edilmez.

Başarılı bir herkese açık depoyu, 404’ü ve çevrimdışı modu tekrar deneyin. Sonraki sorgunun başında önceki kartı temizleyin. Hata olduğunda eski sayılar kalmamalı, alınamayan veri sıfırla değiştirilmemeli.

  • Yeni sayıyı doğrular ve neyi saydığını doğru adlandırır.
  • Yeni sorgu başarısız olduğunda eski başarı sonucu ekranda kalmaz.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin