Ad listesi mi, içerik kaydı mı?
Bir topluluk seçicisi hazırlamak istiyorsanız önce /v1/subreddits yolunu değerlendirin. Ana sayfadaki https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3 örneğinde prefix adın başlangıcını, limit istenen üst sınırı belirtir. Bu bir konu kategorisi veya gönderi metni araması değildir. Dönen adları yerel bir seçim listesine taşıyabilirsiniz; listeyi tüm Reddit’in veya arşivin eksiksiz envanteri olarak sunmayın.
Topluluk sonuçlarının alfabetik sırada veya küresel olarak kesin sayımlarla geldiği garanti edilmez. Yerel sıralama yapmanız mümkündür, fakat yalnızca aldığınız adlara uygulanır. Bir adın görünmesi bütün gönderi ve yorumlarının arşivde bulunduğunu kanıtlamaz. Sonraki içerik sorgusunun yanıtını ayrıca değerlendirin. Boş bir önek sonucu da bütün Reddit’te o ad başlangıcına sahip hiçbir topluluk yok demek değildir.
Reddit API Hub bağımsız bir geçmiş arşividir; resmî veya canlı Reddit hizmeti değildir. OAuth, yazma, oylama ve mesajlaşma sağlamaz. Bir yolun uygun görünmesi, belirli bir dönem veya kaydın kullanılabilirliğini garanti etmez. Görevinizin güncel bilgi mi yoksa geçmiş kayıt mı gerektirdiğini baştan belirleyin. Ad seçimi ile içerik kapsamı konusunda farklı sorular sorduğunuzu unutmayın.
Arama, tür listesi ve tekil öğe
Gönderi ve yorum metinlerinde koşullara göre arama için /v1/search kullanılır. Yalnızca gönderi gerekiyorsa /v1/posts, yalnızca yorum gerekiyorsa /v1/comments seçilir. Bu yollar tam konuşma veya otomatik analiz sağlamaz. Her birinin gerçek yanıtındaki alanları inceleyip kendi şemanıza eşleyin. Başlık, metin veya ilişki alanı yoksa ne yapacağınızı tanımlayın; eksik içeriği tahminle tamamlamayın.
Kimliği bilinen tek kayıt için /v1/item?id=... kullanılır. id parametresi posts ve comments filtresi değildir. Arama türündeki yollarda q, subreddit, author, kind, UTC esaslı YYYY-MM-DD biçimindeki from ve to kullanılabilir; to günü dahildir. kind post veya comment olur. min_score alt puan eşiğidir ve sıralama değildir. Topluluk yoluna aynı filtrelerin tamamını taşımayın.
Yanıtlar düz kayıtlardır. Okumak, saymak veya kodlamak için ağaç oluşturmanız gerekmez. İlişkileri incelemek için mevcut parent_id veya link_id ile isteğe bağlı yerel gruplama yapılabilir, ancak bunlar sorgu filtreleri değildir. Eksik üst kayıt ve yorumlar geri gelmez. Bir yorum listesini tam konuşma gibi, gönderi listesini tüm yanıtları içeren bir yapı gibi göstermeyin.
Sonuç sınırı ve güvenli erişim
Arama, gönderi ve yorum sorguları istek başına en fazla 100 kayıt ve sorgu başına en fazla 100 sayfayla sınırlıdır. Her sayfa ayrı istenir. Arşiv belge sırası tarih, ilgi veya puan sırası değildir. eq kesin toplamı, gte alt sınırı, unknown veya null güvenilir toplamın bulunmadığını gösterir. Kesin toplam bile tüm kayıtları sakladığınızı kanıtlamaz. Tarih dilimleri eksiksiz veya tekrarsız toplamayı garanti etmez.
Anahtarı sunucuda tutun ve Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY ile gönderin. Hesap oturum çerezi ayrı bir işlevdedir. Ücretsiz /v1/status yalnızca sabit kapsam ve HTTP yanıtını gösterir; arşivi, anahtarı veya bakiyeyi denetlemez. HTTP 400 için koşulları, 401 için anahtarı, 402 için bakiyeyi düzeltin; 429 için yeni gönderimi erteleyin. Hepsini aynı otomatik yeniden denemeye dönüştürmeyin.
Başarılı ve boş sonuç dahil veri alma bir kredi harcar. Geçersiz istekten kredi düşülmez; üst kaynak hatasında ayrılan kredi geri verilir. İstemci yanıtı kaybetmeden sunucuda ücretli başarı oluşabilir ve başarılı tekrar ayrıca ücretlidir. Hangi sayfaları sakladığınızı kendi iş kayıtlarınızla takip edin. Teknik koşullar Belgeler, bütçe Fiyatlandırma, hesap işlemleri API anahtarı al sayfasındadır. Doğru yol seçimi, arşiv kapsamının garantisi değildir.
