Yollar ve kimlik bilgileri
Temel adres https://api.getredditdata.com üzerindedir. GET /v1/search genel arama, /v1/posts gönderi, /v1/comments yorum listeleridir. /v1/item?id=... bilinen tek öğe içindir; /v1/subreddits?prefix=... topluluk adlarını önekle daraltır. /v1/status statik hizmet açıklamasıdır. Bu bağımsız geçmiş arşivi resmî Reddit hizmeti değildir. Canlı veri, OAuth, yazma, oylama ve mesajlaşma yoktur. Arşive uyan seçkiyi bütün platformun temsili örneklemi veya silinmiş her içeriği kurtaran bir çıktı olarak tanımlamayın.
Authorization: Bearer YOUR_API_KEY ve X-API-Key: YOUR_API_KEY geçerli iki başlıktır. Bu alan adının arşiv anahtarı kullanılır; Reddit OAuth belirteci değil. Gerçek değeri sunucuda ekleyin, açık kod ve çalışma tablosunda bırakmayın. Panelin Secure HttpOnly oturum çerezi farklıdır. Hesap, anahtar ve bakiye diğer markalarla ortak değildir. İlk deneme https://api.getredditdata.com/v1/search?q=sampling&subreddit=AskStatistics&limit=3 biçimindedir. Bu rastgele örnekleme değildir ve üç kayıt garantisi vermez. Yerel tablo dönüşümü API’nin hazır dosya veya otomatik analiz sunduğu anlamına gelmez.
Filtreler ve kayıtlar
Listelerin filtreleri q, subreddit, author, kind, from, to, min_score, limit ve page alanlarıdı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 eşiğidir, 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 ancak sorgu filtresi değildir. Desteklenmeyen parametrelerle tam konuşmayı istemeye çalışmayın; filtrelerin seçkiden neleri çıkardığını yöntem notunda tutun.
Her başarılı veri alma isteği, sonuç boş olsa bile bir kredi ücretlendirir. API, her istek için en fazla 100 kayıt ve her sorgu için 100 sayfa sınırı uygular. Arşiv belge sıralaması kronolojik veya skora dayalı değildir; bu nedenle sayfa yineleme, kapsamlı bir arşiv çıktısı veya tüm eşleşen kayıtların tam olarak işlenmiş olduğu anlamına gelmez. eq kesin kayıt toplamı, gte alt sınır, unknown veya null güvenilir toplamın bilinmediğidir. Toplam sayfa sayısı değildir. Kesin sayı istemcinin hepsini sakladığını kanıtlamaz. İlişki gruplaması isteğe bağlıdır; düz kayıtları okumak veya saymak için ağaç gerekmez ve eksik ebeveynler geri gelmez. Yerel tabloda kaynak alanları kendi kategorilerinizden ayırın; topluluk sonuçları eksiksiz alfabetik envanter değildir.
Hata, maliyet ve durum
Başarılı çekme boş sonuç dahil bir kredi tüketir; 1.000 başarılı istek $1’dir. Geçersiz istekler kredi düşürmez ve üst sistem hatalarının rezervasyonları geri verilir. İ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. Yerel dosya yazımı ile API çağrısını ayrı izleyin. Mevcut yanıtı yeniden işleyebiliyorsanız bunun yeni veri çekmeden farklı olduğunu kullanım kaydınızda belirtin.
400 parametre ve değer düzeltmesi, 401 eksik veya geçersiz 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 anahtarsız ve ücretsizdir fakat statik kapsam ve HTTP yanıtı dışında arama deposu, kayıt, anahtar veya bakiye testi yapmaz. Kalıcılık, değişmezlik, tam kapsam ve performans garanti edilmez. Sorgu koşullarını, gerçek alınan sayfaları ve yerel dönüşümleri raporlayın; bu kayıtlar gelecekte aynı sonucun döneceğini de garanti etmez.
