Yollar ve yetkilendirme
Temel adres https://api.redditcollector.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. Bu yollar tam arşiv kopyası, rastgele örnek veya değişmez araştırma derlemesi oluşturmaz. Ö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.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3 en çok üç gönderi 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
Ana filtreler arasında q, subreddit, author, kind, from ve to ISO tarihleri yer alır. kind parametresi sadece post veya comment değerlerini kabul eder. min_score parametresi yalnızca bir filtre olarak çalışır ve sonuçları puana göre sıralamaz; bu ayrım veri filtreleme mantığında kritik öneme sahiptir çünkü sonuçların sırasını etkilemez. Tarihler UTC esaslı YYYY-MM-DD biçimindedir; to son günün tamamını içerir. q, subreddit, author, kind, from, to, min_score, limit ve page desteklenen filtrelerdir. id yalnızca /v1/item?id=... içindir; gönderi ve yorum listelerinde id filtresi yoktur. parent_id ve link_id yanıt alanları olabilir ama sorgu filtresi değildir. Tarihleri yerel saat diliminden dönüştürürken yalnızca gün hassasiyetinin desteklendiğini araştırma notunda belirtin.
İ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.
İ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 araştırma kodlama kararları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.
