Yollar ve yetkilendirme
Temel adres https://api.redditapilabs.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. Bu bağımsız geçmiş arşivi resmî Reddit hizmeti değildir; canlı veri, OAuth, yazma, oylama veya mesajlaşma yoktur. Protokolde bu kaynak sınırını belirtin. Araştırma yönteminizi belgelemek arşivin değişmezliği, kalıcılığı veya örneklemin temsil gücü için garanti oluşturmaz.
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 protokoldeki başlık örneğinde yer tutucuyu koruyun. Panelin Secure HttpOnly oturum çerezi ayrıdır. Hesap, anahtar ve bakiye diğer markalarla ortak değildir. Örnek https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 üç sonuç garantisi veya rastgele örnekleme değildir. Parametreleri ve gerçek yanıtı ayrı kaydedin; anahtarı kamuya açık kod, günlük veya araştırma dosyasına yazmayın.
Filtreler ve kayıt yapısı
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 eşiğidir, sıralama veya kalite testi değildir. id yalnızca /v1/item içindir; gönderi ve yorum listelerinde kimlik filtresi değildir. parent_id ve link_id yanıt alanları olabilir ama sorgu filtresi değildir. Bu kuralları ve seçilim etkilerini protokole yazın; filtre adlarını çevirmeden desteklenen biçimleriyle gönderin.
İstek başına en çok 100 kayıt, 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ı hepsinin yerelde saklandığını kanıtlamaz. Düz kayıtların ilişki gruplaması isteğe bağlıdır; okumak ve saymak için ağaç gerekmez, eksik ebeveynler geri gelmez. Sayfa döngüsü, tarih bölme ve tekrar ayıklama tamlığı kanıtlamaz; topluluk sayımları kesin küresel envanter değildir.
Hata, maliyet ve yerel kanıt
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 ile yerel dosya yazımını ayrı izleyin. Mevcut yanıtı yeniden işlemek yeni çağrı değildir; yeniden almak yeni istektir. Protokolde bu iki işleme farklı durum verin.
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. Özgün yanıt, koşullar, zaman, sayfalar, yerel dosya karması ve kod sürümü sizin ortamınızda kaydedilebilir. Bu yerel kanıt API’nin sabit sürüm verdiğini veya aynı sorgunun gelecekte aynı sonucu döndüreceğini kanıtlamaz; performans ve sürekli erişim de garanti edilmez.
