Yol ve yetkilendirme seçimi Filtreler ve sonuç sınırları Dönüşüm sonucu ve hata teşhisi Yol ve yetkilendirme seçimi Temel adres https://api.redditextract.com şeklindedir. GET /v1/search metin araması, /v1/posts gönderiler ve /v1/comments yorumlar içindir. /v1/item?id=... bilinen tek kayıt içindir. /v1/subreddits topluluk adı keşfi için prefix ve limit kabul eder; içerik aramasının diğer filtrelerini veya page dolaşımını bu yola taşımayın. /v1/status korumalı kayıt çekiminden ayrı, açık bir statik hizmet açıklamasıdır.
Authorization: Bearer YOUR_API_KEY ve X-API-Key: YOUR_API_KEY alternatifleri desteklenir. İkisi de bu alan adının arşiv anahtarını taşır; Reddit OAuth kullanmaz. Anahtar, hesap ve bakiye başka sitelerle ortak değildir. Tarayıcıdaki Secure HttpOnly hesap oturumu, uygulamanızın veri çekme başlığının yerine geçmez. Gerçek anahtarı sunucu yapılandırmasında tutun ve örnek yanıtlarla birlikte yayımlamayın.
Veri çekme işlemleri sırasında /v1/item yolunu kullanırken id parametresi zorunludur. Ancak /v1/posts ve /v1/comments yolları için id parametresi gerekmez. Bu ayrım, API'nin esnek yapısını yansıtır ve geliştiricilerin doğru son nokta seçimi ile veri karmaşıklığını yönetmelerini sağlar. Yalnızca ilgili verileri istemek, bant genişliğini ve işleme süresini optimize eder. Ancak id, gönderi veya yorum listelerine isteğe bağlı filtre olarak da eklenmez. Bilinmeyen parametreleri göndermek yerine seçtiğiniz yolun sözleşmesini izleyin.
Filtreler ve sonuç sınırları İçerik yolları q, subreddit, author, kind, from, to, min_score, limit ve page kullanır. kind yalnızca post veya comment olabilir. from ve to UTC içinde YYYY-MM-DD günleridir; to son günün tamamını kapsar. min_score minimum puan filtresidir, sıralama denetimi değildir. parent_id ve link_id bazı yanıtlarda bulunabilir fakat arama parametresi değildir; kendi ek alanlarınızı API’ye filtre diye göndermeyin. from ve to, içeriğin oluşturulma zamanı olan created_utc alanını filtreler; veri alma veya arşive ekleme zamanını değil.
limit 1–100, page 1–100 aralığındadır. Sonuçlar _doc belge sırasındadır; kronolojik, ilgi veya puan sırası beklemeyin. Toplamın ilişkisi eq olduğunda sayı kesin, gte olduğunda alt sınır, unknown olduğunda güvenilir toplam bilinmiyor olabilir; değer null olabilir. Bunları tek bir kesin sayaca indirgemeyin. Sayfa dolaşımı veya tarih bölme bütün eşleşmelerin alınacağını kanıtlamaz.
PostgreSQL içinde q=index ve limit=3 ile başlayarak alınan alanları kaydedebilirsiniz. Yanıt düz kayıtlar içerir; hazır konuşma ağacı veya sabit şema paketi değildir. İsteğe bağlı alanlar ve tür farklılıkları için uygulamanızda kurallar tanımlayın. İlişki alanları varsa gruplama yapılabilir, ancak eksik ebeveynlerin geri kazanılması ve konuşmanın tamamlanması bu işlemden çıkmaz. Alan seçimi yanıtı aldıktan sonra yerel olarak yapılır; fields gibi belgelenmemiş bir parametre ekleyerek sunucudan özel şema istemeyin.
Dönüşüm sonucu ve hata teşhisi Kaynak yanıtın ham kopyası ile hedef tablonun üretimini ayrı aşamalarda ele alın. Alan adını değiştirme, boş değer politikası, metin temizleme ve zaman birimi dönüşümü sizin kodunuzun kararlarıdır. Başarısız bir dönüşümü kaynakta kayıt yokmuş gibi göstermeyin. Hangi kaydın hangi kurala takıldığını belirtmek, bütün sorguyu tekrar çalıştırmadan yerel düzeltmeyi sınamanıza yardımcı olabilir.
400 geçersiz parametre, 401 eksik veya geçersiz anahtar, 402 yetersiz kredi, 429 hız sınırı anlamına gelir. Geçersiz istek kredi düşürmez; üst sistem hatalarında rezervasyon iade edilir. Başarılı boş yanıt bir kredidir. /v1/status kayıt mevcudiyetini, arama altyapısını veya bakiyeyi denetlemez. Yanıt kaybı sunucu başarısını dışlamaz; başarılı yeniden deneme de ücretlidir.
Her başarılı çekme $0,001 karşılığı bir kredidir; $50 yükleme 50.000 ücretli kredi sağlar. Aynı ham yanıtı başka hedef şemayla yerel olarak işlemek yeni çağrı değildir. Kaynak sorgu, alma zamanı, kural sürümü ve yazma sonucunu ayrı izleyin. Bu kayıtlar kendi işleminizi açıklamanızı sağlar fakat kalıcı arşiv, aynı yanıtı tekrar alma veya tam kapsam garantisi yaratmaz.
