Yollar ve yetkilendirme
Temel adres https://api.redditdatasets.com üzerindedir. GET /v1/search genel arama, /v1/posts gönderi, /v1/comments yorum listeleridir. /v1/item?id=... bilinen tek öğeyi sorgular; /v1/subreddits?prefix=... topluluk adlarını önekle daraltır. /v1/status statik hizmet açıklamasıdır. Bağımsız geçmiş arşivi resmî Reddit hizmeti değildir; canlı veri, Reddit OAuth, yazma, oylama ve mesajlaşma sunmaz. Bu yollar filtrelenmiş kayıtları almak içindir. Hazır etiketli veri kümesi, toplu indirme, rastgele örnekleme veya değişmez sürüm oluşturmazlar. Örnek açıklaması ve seçim ölçütleri kullanıcı tarafından hazırlanır.
Authorization: Bearer YOUR_API_KEY ve X-API-Key: YOUR_API_KEY geçerlidir. Bu alan adının arşiv anahtarı kullanılır; Reddit OAuth belirteci değil. Gerçek değeri sunucuda ekleyin ve paylaşılan dosya ile günlüklerden çıkarın. Panelin Secure HttpOnly oturum çerezi ayrıdır. Hesap, anahtar ve bakiye diğer markalarla ortak değildir. Örnek https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3 en çok üç yorum ister, üç kayıt garantisi vermez. İlk sayfa rastgele örnek değildir. Kaynak notuna topluluk ve limiti, gerçekten kaydedilen kayıt sayısından ayrı yazın; kayıtların kaynağını yanıtın mevcut alanlarıyla değerlendirin.
Filtreler, sıra ve kapsam
Arama, gönderi ve yorum listelerinde q, subreddit, author, kind, from, to, min_score, limit ve page kullanılır. kind post veya comment olur. Tarihler UTC esaslı YYYY-MM-DD’dir; to belirtilen günün tamamını içerir. min_score minimum puan filtresidir, sıralama veya kalite testi değildir. id yalnızca /v1/item içindir; gönderi ve yorum listelerinde kimlik filtresi yoktur. parent_id ve link_id yanıt alanları olabilir ama sorgu filtresi değildir. Tarihleri bölmek planlama tercihidir; bölünmüş dönemlerin tüm kayıtlarını aldığınızın kanıtı değildir. Filtreleri kaynak açıklamanızda koruyun ve seçim gerekçesini yazın.
İstek başına en çok 100 kayıt ve sorgu başına 100 sayfa vardır. Her sayfa ayrı çağrıdır. Belge sırası zaman, ilgi veya puan sırası değildir. eq kesin kayıt toplamı, gte alt sınır, unknown veya null güvenilir toplamın bilinmediğidir. Kesin sayı tüm sonuçları sakladığınızı kanıtlamaz. Düz kayıtları ilişki analizi için isteğe bağlı gruplayabilirsiniz; okumak ve saymak için ağaç gerekmez, eksik ebeveynler geri gelmez. Sayfa döngüsü ve tekrar ayıklama tamlığı veya tekrarsızlığı kanıtlamaz; topluluk sayımları kesin küresel envanter değildir.
API yanıtları düz kayıtlar içerir; sunucu tarafından oluşturulmuş bir ağaç yapısı değildir. Müşteriler, gelen verileri yerel olarak gruplayabilir. Ancak, bu yapı bir ağaç hiyerarşisi garantisi vermez. Ebeveyn veya bağlantı alanları mevcutsa, bunlar isteğe bağlı olarak işlenebilir. Tam bir konuşma geçmişi garantisi yoktur.
İstek hatası, maliyet ve yerel örnek
Başarılı çekme boş sonuç dahil bir kredi tüketir; 1.000 başarı $1’dir. Geçersiz istekler kredi düşürmez; üst sistem hataları rezervasyonları geri verir. İstemci zaman aşımı sunucu başarısızlığını kanıtlamaz. Yanıt kaybolmuşsa başarılı tekrar yeni kredi tüketebilir. Salt okunur erişim aynı yanıt veya ücretsiz tekrar sözü değildir. API sonucu, yerel dosyaya kaydetme, temizleme ve etiketleme kararını ayrı izleyin. Kaydedilmiş yanıtı yeniden işlemek yeni çağrı değildir. Yerel örneğin sürüm notu, sunucuda sabit anlık görüntü bulunduğunun veya gelecekte aynı verinin tekrar alınabileceğinin kanıtı olmaz.
400 parametre düzeltmesi, 401 anahtar denetimi, 402 bakiye kontrolü, 429 sıklığı azaltma gerektirir. Deneme sayısı ve durma koşulu belirleyin; başka hesaplarla sınırı aşmayın. /v1/status açık ve ücretsizdir fakat statik kapsam ve HTTP yanıtı dışında arama deposu, kayıt, anahtar veya bakiye testi değildir. Görevin her aşaması için gerçek başarıyı denetleyin. Tam kapsam, kalıcılık, değişmezlik, belirli performans ve sürekli erişim garanti edilmez. Sonuçları düzenli istemek de bir canlı değişiklik kaydı oluşturmaz; arşiv güncelleme sıklığı buradan çıkarılamaz.
