Yollar ve kimlik bilgileri
Temel adres https://api.redditapicloud.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 kapsam açıklamasıdır. Hizmet bağımsız geçmiş arşividir; resmî Reddit hizmeti, canlı veri, OAuth, yazma, oylama veya mesajlaşma sunulmaz. Bu arşivi çağırmak için Elasticsearch çalıştırmanız gerekmez, ancak ürününüzün kullanıcı yetkilerini ve sonuç ekranını yine sizin uygulamanız yönetir.
Authorization: Bearer YOUR_API_KEY ve X-API-Key: YOUR_API_KEY geçerlidir. Değer bu alan adının arşiv anahtarıdır, Reddit OAuth belirteci değildir. Gerçek değeri sunucuda ekleyin; açık kodda, tarayıcı paketinde veya günlüklerde bırakmayın. Hesap panelinin Secure HttpOnly çerezi ayrıdır. Hesap, anahtar ve bakiye diğer markalarla ortak değildir. Örnek https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3 üç sonuç garanti etmez. Ürün sunucusu kullanıcı yetkisini doğrulayıp yalnızca izin verilen istekleri geçirmelidir; anahtar saklamak tek başına erişim denetimi değildir.
Filtreler ve kayıtlar
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 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. Barındırılan sorgu, keyfî Elasticsearch sorgu dili veya özel sunucu analizi sunulduğu anlamına gelmez.
İstek başına en çok 100 kayıt ve sorgu başına 100 sayfa vardır. Her sayfa ayrı çağrıdır. Sonuçlar zaman, ilgi veya puan değil belge sırasındadır. eq kesin kayıt toplamı, gte alt sınır, unknown veya null güvenilir toplamın bilinmediğidir. Kesin sayı hepsini 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. Tarih bölme veya tekrar ayıklama tamlığı kanıtlamaz; topluluk sayımları kesin küresel envanter değildir.
Maliyet, hata ve durum
Başarılı çekme boş sonuç dahil bir kredidir; 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. Yerel dosya yazımı ile API çağrısını ayrı izleyin. Mevcut yanıtı yeniden işlemek ile arşive yeni çağrı göndermek farklıdır; ürün bütçesinde bu ayrımı koruyun.
400 parametre ve değer 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. Ürün kullanıcılarına boş sonuç ile geçici hatayı ayrı gösterebilirsiniz. Böyle bir ekran servis garantisi oluşturmaz. Tam kapsam, değişmezlik, kalıcılık ve performans garanti edilmez; sorgu ve uygulama işleme sonuçlarını ayrı kaydedin.
