Uygulamanızda Kaydet’in ne anlama geldiğine karar verin
Önerilen yürüyüş uygulamasında Kaydet, seçilen geçmiş kaynağı daha sonra okumak için mevcut cihazda tutmak demektir. Bu, uygulamanızın geliştireceği bir özelliktir; arşiv uç noktası değildir. Reddit App API yer imleri, cihazlar arası eşitleme veya kayıtlı liste hesabı sağlamaz. Yürüyüşçü seyahatte listeye güvenmeden önce bu farkı açıklayın.
Yürüyüşçü bir tartışmayı sonraya kaydettiğinde uygulama, tüm gönderi gövdesini çoğaltmak yerine asgari kaynak referansı saklamalıdır. Mevcutsa kayıt kimliğini, doğrulanmış bağlantıyı ve seçimi tanımaya yetecek kaynak bağlamını tutun. Kullanıcının seçtiği kısa bir alıntıyı da saklıyorsanız bu tercihi açıkça belirtin; içerik ve üçüncü taraf haklarını değerlendirin.
Üç tarihi tek bir tarihe dönüştürmeyin
Uygulama, kaydın özgün oluşturulma zamanı ile kullanıcının onu kaydettiği zamanı ayırmalıdır. Seçilen içeriği ne zaman aldığını da tutabilir. Bu cihazda kaydedildi gibi bir etiket uygulama eylemini anlatır; tartışmanın o tarihte yazıldığı, kontrol edildiği veya yenilendiği anlamına gelmez. Bulunmayan özgün tarihi bilinmiyor bırakın.
Kaydedilmiş başlık veya alıntıyı mevcut kaynağın hâlâ aynı şeyi söylediğinin kanıtı saymayın. Uydurma ayrıntılar eklemeden seçimin bağlamını koruyun. Kısmi sonuçtan kaydedilen yorum, tüm konuşma veya çevresindeki her yanıtın daha sonra bulunacağına dair garanti değil, o kayda ait referans olarak kalır.
Yerel açmayı yeni sorgudan ayırın
Yerel liste, tuttuğu meta verileri veya alıntıyı hizmeti tekrar çağırmadan gösterebilir. Liste her açıldığında tüm öğeleri sessizce yenilemek yerine yeni sorguyu bilinçli bir eylem yapın. Her başarılı veri alımı bir kredi tüketir; açıkça yapılan /v1/item?id=RECORD_ID çağrısı da istektir. Arşiv anahtarı arka ucunuzda kalmaya devam eder.
Kayıt sorgusu hiçbir kayıt dönmediğinde başarılı boş data dizisi döndürebilir; eksik kayıt için hizmetin 404 ya da 410 kullandığını varsaymayın. Bu boş başarı ücretlendirilir. Başarısız istek veya kayıp yanıt da öğenin silindiğini kanıtlamaz. Bu sorguda bulunamadı, İstek başarısız ve Yeniden kontrol edilmedi için farklı etiketler kullanın.
Verilen sözle uyumlu yerel kontroller sunun
Önerilen liste için açık bir Bu cihazdan kaldır eylemi sağlayın. Bu, uygulamanızın tasarımına göre yerel kaynak referansını ve ilişkili alıntıyı kaldırmalıdır. Reddit gönderisini veya arşiv kaydını silmez, hizmet hesabını kapatmaz ya da ödeme kayıtlarını değiştirmez. Yerel kontrolü daha geniş bir silme talebi olarak sunmayın.
Depolama sınırı veya süre kuralı seçerseniz hizmet için saklama süresi uydurmak yerine uygulamanın o kuralını açıklayıp test edin. Okuyucu neyin kaldırılacağını anlayabilsin. Cihaz temizliği, tarayıcı depolama kısıtları veya uygulama verilerinin temizlenmesi de yerel içeriği kaldırabilir. Bir öğe kaydedildi diye sürekli erişim vaat etmeyin.
Çevrimdışı beklentiyi dar ve açık tutun
Yalnızca kaynak referansları içeren liste, kaynağı açmak için bağlantıya ihtiyaç duyabilir. Uygulamanız saklamayı gerçekleştirip sürdürüyorsa alıntı yerelde okunabilir; ancak bu, bütün tartışmayı veya haritayı çevrimdışı yapmaz. Yürüyüşçü bağlantıdan ayrılmadan önce gerçekte hangi içeriğin saklandığını gösterin. Bu rehber böyle bir çevrimdışı özelliğin geliştirildiğini veya test edildiğini iddia etmez.
Bu uygulama deposunu hizmet sitesinin hesap oturumundan ve son fatura referansından ayrı tutun. Bileşen ana makine başına invoice id ve user id saklayabilir; bu mekanizma okuma listesi değildir ve asla API anahtarını saklamak için yeniden kullanılmamalıdır. Yedekleme, dışa aktarma veya cihazlar arası eşitleme, tasarlayıp açıklayacağınız ek birer özellik olur. Kayıt eşleme ve istek bütçesi için /tr/#field-notes bölümüne dönün.
