İlk ekranın ne anlatacağını belirleyin
Bir yorum önizlemesi küçük bir soruyla başlayabilir: uygulamanız elindeki kayıtlardan hangilerini gösterebilir? Reddit Fetch, JavaScript geliştiricilerine bağımsız bir geçmiş Reddit arşivini sorgulama olanağı verir. Önce tek bir topluluk seçin ve yorum metni eksik olduğunda ekranda ne yazacağını kararlaştırın. Böylece aldığınız her kayıt, belirsiz bir veri toplama hedefi yerine uygulamanızdaki somut bir görüntüleme ihtiyacına hizmet eder.
Örnek istek GET https://api.redditfetch.com/v1/comments?subreddit=javascript&limit=3 adresini kullanır. subreddit=javascript topluluğu seçer; limit=3 ise en fazla üç yorum ister. Bu sayı, üç dolu kart geleceği anlamına gelmez. Daha az kayıt gelebilir veya başarılı yanıt boş olabilir. Dönen yorumların aynı konuşmaya ait olması da gerekmez. Ekranda yan yana görünmeleri, aralarında bir yanıt ilişkisi bulunduğunu tek başına göstermez.
İsteği kendi sunucu sürecinizde çalıştırın
fetch çağrısını Node.js hizmetinde yapın ve REDDIT_FETCH_API_KEY değerini özel sunucu yapılandırmasından okuyun. İstekten önce değerin bulunduğunu kontrol edin. Authorization: Bearer <key> ve X-API-Key: <key> başlıklarının ikisi de desteklenir. Örnekteki yer tutucu, sakladığınız gerçek anahtarı temsil eder. Bu değer ziyaretçinin tarayıcısına gönderilen JavaScript paketinin parçası olmamalıdır; tarayıcı önizlemeyi görürken arşiv anahtarını bilmek zorunda değildir.
İlk denemede hedef adresi sabit tutun. Sunucunuz yanıtı denetledikten sonra yalnızca ekranın ihtiyaç duyduğu sınırlı bir gösterim döndürebilir. Anahtarı kullanıcıya iletmeyin ve ziyaretçinin yazdığı herhangi bir URL’yi anahtarlı isteğin hedefi olarak kullanmayın. Kimin önizlemeyi yenileyebileceğini ayrıca belirleyin. Anahtarı gizlemek, herkese açık uygulama yolunuz üzerinden yapılan ücretli çağrıların sayısını kendiliğinden sınırlamaz.
Boş sonuç ile başarısız yüklemeyi ayırın
fetch sözünün tamamlanması HTTP isteğinin başarılı olduğunu kanıtlamaz. Gövdeyi yorum verisi olarak ele almadan önce response.ok değerine bakın; sonra JSON çözümlemesini ve gerekli alanları kontrol edin. Ağ istisnası ayrı bir sonuçtur, JSON çözümlemesi de yanıt geldikten sonra başarısız olabilir. Hepsini boş listeye dönüştürürseniz hem kullanıcı hem de kendi tanılama kayıtlarınız asıl nedeni kaybeder.
Yorumlar düz kayıt parçalarıdır. Kullanılabilir metni denetleyin, eksik alan için yerel bir açıklama seçin ve içeriği metin olarak gösterin. Yükleniyor, hazır, boş ve başarısız durumlarını uygulamanız tanımlar. Boş bir arşiv örneği, toplulukta yorum bulunmadığını göstermez. Üç parça da eksiksiz bir konuşma ağacı oluşturmaz; arayüzde böyle bir izlenim vermemek, örneğin gerçek kapsamını okura anlatmayı kolaylaştırır.
Yeni çağrı için bilinçli bir neden seçin
Boş olsa bile her başarılı veri alma isteği bir kredi kullanır. Ücret 1000 başarılı istek için $1; en düşük $50 yükleme 50000 ücretli kredi sağlar. Deneme kredileri uygunluk koşullarına bağlıdır. Önceden saklanan yerel yanıtı yeniden kullanmak yeni çağrı gerektirmez. Başarılı bir yenileme ise görünen metin değişmese bile bir kredi daha harcar; ekranın yeniden açılması mutlaka yenileme yapmak zorunda değildir.
Arşiv bağımsızdır; Reddit ile resmî bağlantısı veya canlı yorum akışı yoktur. Tam kapsam, kalıcı erişim ve değişmez yanıt garantisi verilmez. Önizlemeyi geçmiş veri olarak etiketleyin ve arşiv sırasını en yeni yorumların sırası sanmayın. Anahtar sayfası sunucu yapılandırmasını, rehber hata işleme adımlarını, belgeler ise yanıt sözleşmesini açıklar. Bir sonraki adımı, önizlemenizde henüz cevaplanmamış olan soruya göre seçebilirsiniz.