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

Mini ders 16 / 30 · Veri ve yapay zekâ ekleyin

Hazır sorgulamayı açın

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.

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

Bu derste ne öğreneceksiniz?

  • 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.
Açıklama, çözülmüş örnek ve alıştırma

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.

Başlamak için gereken beceriler

Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.

  1. İlk kişisel web sitenizi nasıl kurarsınız?

    Verilen başlangıç projesinden bir tanıtım, projeler bölümü ve iletişim yolu oluşturun.

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.

Konuyu anlayalım

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.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Hangi depoyu sorguladınız ve çalışan sayfa gerçekte hangi sonucu gösterdi?

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

Uydurma sayılı örnek sorgu kaydı: “Test anında octocat / Hello-World istedim. Sayfa octocat/Hello-World ve 12 stars döndürdü; görünür kimlik ve sayı, incelediğim yanıtla eşleşti.” 12, bu örneği anlamak için hayali ölçümdür; o depo hakkında güncel bilgi değildir.

Yıldız sayıları değişebilir. Kaydınızda gerçekten gözlediğiniz sayı ve test saati olmalı; hizmet yanıt vermediyse bu örnek sayıyı koymak yerine o durumu bildirin.

İyi bir cevap neleri içermeli?

  • Gerçekte istenen herkese açık sahip/depo adını ve dönen kimliği belirtir.
  • Örnek bir değeri sabitlemeden gözlenen sayıyı/zamanı veya tam hizmet hatasını bildirir.
Nasıl çalışır? (isteğe bağlı)

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

Ek teknik alıştırma

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 1 · Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?

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

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Sayfa sonucu, incelediğiniz depo yanıtıyla eşleşti mi?

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

Hayali yanıt değerleriyle örnek eşleme: full_name = practice/example ve stargazers_count = 12 içeren yanıt, practice/example ve 12 stars göstermeli. Önceki deponun adını tutmamalı veya eksik sayıyı sıfıra çevirmemeli.

Canlı kontrolde o anda sorguladığınız depodan gelen gerçek yanıtı kullanın. İstek sınırı yanıtı, gösterilecek normal yıldız sonucu içermez.

İyi bir cevap neleri içermeli?

  • Sayfanın kimliğini ve yıldız sayısını aynı herkese açık hizmet yanıtıyla eşleştirir.
  • Hata yanıtını veya eksik alanı normal sıfır değerli sonuç gibi sunmaz.
Nasıl çalışır? (isteğe bağlı)

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;

Ek teknik alıştırma

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 2 · Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?

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

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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.

Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

İki hata örneği ne gösterdi ve ziyaretçi devam edebildi mi?

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

Örnek hata kaydı: “Uydurma depo adı Repository not found or not publicly accessible gösterdi. Yerel hata testi için istek bilerek engellenince sorgu hata gösterdi; sahip/depo alanları kullanılabilir kaldı ve düğme yeniden denenebildi.”

Engellenen istek bir benzetimdir; gerçek GitHub kesintisinin kanıtı değildir. İstek sınırı, özel hesap token’ını herkese açık sayfa koduna koymaya değil, daha sonra tekrar denemeye götürmeli.

İyi bir cevap neleri içermeli?

  • Olmayan depo ile asistan yardımıyla yapılan başarısız istek testinin farklı sonuçlarını kaydeder.
  • Tarayıcıya özel token koymadan sorgunun düzeltme veya tekrar deneme için kullanılabilir kaldığını kontrol eder.
Nasıl çalışır? (isteğe bağlı)

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ı

Ek teknik alıştırma

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 3 · Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?

Faydalı bir sonuç ekleyin

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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

Buradan başlayınUygulama dosyaları

Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.

Sıra sizde

Açık issue ve pull request toplamını ekleyin. Görünen değer yanıtla nasıl karşılaştı; bulunamayan/kullanılamayan testlerinde ne oldu?

Hazırlanacak çıktı: Güncellenen sorgulama sayfası ve gözlemlenen normal, bulunamayan ve hizmet hatası sonuçları.

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

Örnek eşleme: “open_issues_count = 5 içeren hayali yanıtta sayfa 5 open issues and pull requests gösteriyor. Toplam iki issue ile üç pull request içerebilir; beş yazılım hatasının sayısı değildir.”

Örnek test kaydı: “Normal sorgu yanıtla eşleşti; olmayan depoda bulunamadı mesajı kaldı; engellenen istek benzetiminde yeniden denenebilir hata kaldı.” Tesliminiz canlı eşleşen değerinizi içermeli ve yapmadığınız kontrolleri belirtmeli.

İyi bir cevap neleri içermeli?

  • open_issues_count değerini yalnızca hata veya issue değil, open issues and pull requests olarak gösterir.
  • Yeni değeri bir yanıtla karşılaştırır; normal, bulunamayan ve kullanılamayan durumları tekrarlar.
Nasıl çalışır? (isteğe bağlı)

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

Ek teknik alıştırma

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.