Reddit App API
TR

Reddit App API · 01 / 08

Gezi planlama yolculuğuna bir okuma durağı ekleyin

Örnek bir çevrimdışı harita okuma özelliğini adım adım ele alın: soruyu seçin, tek bir sınırlı istek yapın ve eski tartışmaları navigasyondan ayırın.

Arşivin araştırmaya yardımcı olabileceği bir soru seçin

Bu ayrıntılı tasarım varsayımsaldır. Bir yürüyüşçü rotasını seçmiş, telefonunu güvenilir bağlantıdan uzakta kullanmaya hazırlanmaktadır. Başkalarının çevrimdışı haritaları nasıl tartıştığını okumak ister: önceden neler indirilmeli, cihazla ilgili hangi varsayımlar kontrol edilmeli ve seçilen yazılım hakkında hangi sorular sorulmalıdır? Arşiv, harita sağlayıcısı değil, geçmiş tartışmaların kaynağıdır.

Okuma özelliğini adım adım yön tarifinin içine değil, hazırlık notlarının yanına koyun. Bir sonuç, rotanın yanında görünüyor diye doğrulanmış bir patika koşuluna dönüşmemelidir. Harita indirme, konum izni, güncel kapanmalar ve güvenlik bilgileri uygulamanın uygun bölümlerinde kalmalıdır. Bu ayrım geçmiş deneyimlere, sahip olmadıkları bir yetki atfetmeden yararlı bir rol verir.

Tek, küçük ve bilinçli bir istek gönderin

Önerilen offline maps sorgusu ve hiking subreddit’iyle başlayın. İstemci bu tercihleri arka ucunuza yollar; arka uç kayıtlı hizmet anahtarıyla /v1/search?q=offline%20maps&subreddit=hiking&limit=3&page=1 çağrısı yapabilir. Bu bir istek tasarımıdır, eşleşen üç kaydın varlığına dair kanıt değildir. Anahtar arka uçta kalır ve yürüyüşçünün girdisinin parçası olmaz.

Küçük bir ilk sayfa, büyük bir akış tasarlamadan önce okuma görevini tasarlamanızı sağlar. q, title ve text üzerinde AND eşleştirmesi kullanır; ifade, tam ifade veya anlamsal arama talimatı değildir. Yürüyüşçü ifadeyi değiştirirse yeni aramayı uygulamada açıklayın ve sayfa dizisini baştan başlatın. Sorguyu sessizce genişletip yeni sonuçları ilk sorunun yanıtı gibi etiketlemeyin.

Kaydı tavsiye değil, başvuru kaynağı olarak sunun

Arşiv düz kayıtlar döndürür. Kartınız mevcut metni, kaynak topluluğu, geçerli bir oluşturulma tarihini ve kullanılabilir kaynak bağlantısını gösterebilir. Bir yorumun başlığı veya yararlı bağlamı olmayabilir. Başlık ya da tarihin bulunmadığını söyleyin; bunları uydurmayın. Mevcut üst kayıt kimliklerine göre yerel gruplama bazı kayıtları bağlayabilir, fakat eksiksiz bir tartışma oluşturduğunu göstermez.

Arşiv kayıtları belge sırasıyla saklar; kronolojik, alaka düzeyi veya puan sırası kullanmaz. Arayüzü bu sınırla uyumlu yapın: alana en iyi yanıtlar değil, geçmiş kaynaklar deyin. Okuyucu farklı deneyimleri karşılaştırabilir ve mevcutsa kaynağa gidebilir. Başka birinin kurulumuna ilişkin alıntıyı bu cihaz veya gezi için doğrulanmış talimata çevirmeyin.

Yararlı sonuçtan önce yararsız sonucu tasarlayın

Başarılı bir istek hiç kayıt döndürmeyebilir. Girdiyi görünür tutun ve farklı bir terim denemek gibi bilinçli bir değişiklik önerin. Boş durum o yanıtı anlatır; konunun hiç tartışılmadığını kanıtlamaz. Hiç sonuç döndürmese bile her başarılı veri alma isteği bir kredi tüketir. Uygulama operatörü otomatik aramaları açmadan önce bu maliyeti anlamalıdır.

Hata farklı bir durumdur. Soruyu koruyun ve uygun olduğunda tekrar deneme seçeneği gösterin. Hizmet anahtarı ve kredi sorunları operatöre aittir; yürüyüşçüye tartışma aramasının kullanılamadığını kısa biçimde açıklamak gerekir. Hesap ödeme kontrollerini bu okuma akışına yerleştirmeyin veya geciken isteği arşivin çalışmadığının kanıtı saymayın.

Okuyucu sınırlı ama yararlı bir şeyle ayrılsın

pagination.has_more izin verirse Daha fazla göster, aynı filtreler ve limit ile başka bir sayfa alabilir. Okuyucu bunun yerine kaynak referansını uygulamanın yerel listesine kaydedebilir. İki eylem de tam kapsamı, kaynağın kalıcı erişimini veya bütün konuşmanın çevrimdışı kopyasını garanti etmez. Kaynak kaydetmek kullanılabilir bir harita da indirmez.

Yararlı bir kapanış, yürüyüşçünün gerçekten kullandığı harita yazılımında ve güncel rehberlerde kontrol edeceği kısa bir soru listesi olabilir. Bu ölçülmüş fayda değil, tasarım niyetidir. Referansların yeniden göründüğü her yerde geçmişe ait oldukları etiketi korunsun. Kartlara dönüştürme, kaynak yaşı ve yerel okuma listesi kararları için /tr/#field-notes bölümüne dönün.