Yollar ve yetkilendirme
Temel adres https://api.redditdatastream.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ı akış, değişiklik akışı, SSE, WebSocket, OAuth, yazma, oylama ve mesajlaşma yoktur. İstemci bir sayfayı ister ve yanıtı kendi koduyla işler. Hazır JSONL dışa aktarımı veya yerel dosya yazımının sunucu tarafından doğrulanması sunulmaz.
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, dosya ve 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.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3 üçüncü sayfayı ister; üç kayıt garantisi değildir. page kalıcı devam imleci veya zamansal sınır değildir. Aynı sayfa numarasını kaydetmek kayıpsız yeniden başlama garantisi oluşturmaz.
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; alınan son kaydın tarihini önceki dönemin tamamen alındığının kanıtı olarak kullanmayı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.
Hata, maliyet ve dosya durumu
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 JSONL yazımı ve hedefe yüklemeyi ayrı izleyin. Kaydedilmiş yanıtı yeniden işlemek yeni çağrı değildir. Yerel ilerleme kaydı tutmak sunucunun sabit anlık görüntü veya tam bir kez teslim sunduğu anlamına gelmez.
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.
