İstek örneği
cURL
curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditstreamapi.com/v1/posts?subreddit=datasets&limit=3&page=2"Stream adı, canlı bağlantı anlamına gelmez
Reddit Stream API, geçmiş Reddit kayıtları için bağımsız bir arşiv API’sidir. Reddit’in resmî veya bağlantılı hizmeti değildir ve canlı veri sunmaz. SSE, WebSocket, canlı bildirim, OAuth, gönderi oluşturma, oylama veya mesajlaşma yoktur. İstemci, ihtiyaç duyduğu sayfa için ayrı GET isteği gönderir. Toplu işin belirli aralıklarla çalışması da onu canlı akışa dönüştürmez; kayıtların güncellendiğini veya arşivin hangi sıklıkta yenilendiğini buradan çıkaramazsınız. İş akışını mevcut geçmiş kayıtların sınırlı sorgulanması olarak tasarlayın.
Örnek istek https://api.redditstreamapi.com/v1/posts?subreddit=datasets&limit=3&page=2 adresine gönderilen GET isteğidir. subreddit topluluğu, limit azami kayıt sayısını, page istenen sayfayı belirler. Bu örnek ikinci sayfanın veya üç gönderinin mutlaka var olduğunu iddia etmez. İkinci sayfa, tarihte bir sonraki zaman dilimi demek değildir. Sonuçlar arşiv belge sırasındadır; zaman, ilgi veya puan sırasını garanti etmez. Bu adres istek biçimini gösterir; gerçek sonucu çalıştırdığınız çağrının yanıtından değerlendirin.
Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY ile yetkilendirme yapılabilir. Her iki başlık geçerlidir; değer Reddit OAuth belirteci değil, bu alan adının arşiv anahtarıdır. YOUR_API_KEY yalnızca örnek yer tutucusudur. Gerçek değeri sunucu çalıştırma ortamında tutun, herkese açık koda veya iş günlüklerine eklemeyin. Hesap paneli için kullanılan Secure HttpOnly oturum çerezi ayrı bir işlev görür. Toplu işin yapılandırmasında anahtarı, sorgu koşullarını ve yerel iş kimliğini birbirinden ayırın.
Sayfayı ve yerel iş durumunu birlikte kaydedin
Bir toplu işte sorgu koşullarını sabit bir yerel iş tanımına yazabilirsiniz. Her sayfa için istenen yol, filtreler, deneme zamanı, HTTP sonucu ve yerel kaydın tamamlanma durumunu ayrı izleyin. İstek başarılı olsa bile dosya yazımı başarısız olabilir; sadece sayfa numarasını artırmak bunu fark etmeyebilir. Yerel ilerleme kaydı kendi işinizin nerede durduğunu gösterir, sunucunun değişmez bir anlık görüntü veya kalıcı imleç sağladığı anlamına gelmez. Yeniden çalıştırırken hangi sonuçların gerçekten saklandığını kontrol edin.
İstek başına en çok 100 kayıt, sorgu başına en çok 100 sayfa alınabilir. Başlangıçta küçük limit kullanmak veya ihtiyaca göre artırmak istemci tercihidir; her iş için 100 seçmek zorunlu değildir. Tarih pencereleriyle işi bölmek de mümkündür: from ve to UTC esaslı YYYY-MM-DD kullanır, to belirtilen günün tamamını kapsar. Bitişik günleri planlarken bu dahil olma kuralını gözetin. Tarih bölme, sayfa döngüsü ve yerel tekrar temizliği eksiksiz ya da tekrarsız arşiv çıkarımını kanıtlamaz.
Yanıtlar düz kayıtlardır. parent_id ve link_id dönerse ilişki incelemesi için isteğe bağlı gruplama yapılabilir; yalnızca okumak veya saymak için ağaç kurmanız gerekmez. Eksik üst kayıtlar bu işlemle geri gelmez. min_score en düşük puan filtresidir, sıralama komutu değildir. Toplamdaki eq kesin sayıyı, gte alt sınırı, unknown veya null güvenilir toplamın bilinmediğini gösterir. Kesin toplam da istemcinizin bütün eşleşmeleri kaydettiğini kanıtlamaz; topluluk sayımları kesin küresel envanter değildir.
İş bütçesi ve hata ayrımı
Her başarılı veri çekme isteği boş sonuç dahil bir kredi tüketir. Başarılı 1.000 istek $1, en düşük $50 yükleme 50.000 ücretli kredidir. Sayfa değişimi ve başarılı yeniden deneme ayrı ücretlenir. Abonelik yoktur; ücretli krediler sona ermez. Ağ genelindeki kötüye kullanım önleme uygunluğuna bağlı 100 deneme kredisi garanti edilmez. Hesaplar, anahtarlar ve bakiyeler bu alan adına aittir; başka markaların bakiyesini toplu işinizin bütçesine dahil etmeyin.
400 için parametreleri, 401 için eksik veya geçersiz anahtarı, 402 için bakiyeyi, 429 için istek sıklığını inceleyin. Geçersiz istekler kredi düşürmez; üst sistem hatalarının rezervasyonları geri verilir. Ancak yanıt istemciye ulaşmadan önce sunucu başarılı olmuş olabilir. Başarılı tekrar yeni bir kredi tüketebilir; salt okunur erişim aynı yanıtı veya ücretsiz tekrarı garanti etmez. İstemcinizde tekrar sayısını ve durma koşullarını belirleyin, sıklık sınırını farklı hesaplarla aşmayı denemeyin.
/v1/status açık ve ücretsizdir; statik hizmet kapsamı ile HTTP uygulamasının yanıt verdiğini gösterir. Arama deposunu, kayıt varlığını, anahtarı veya bakiyeyi sınamaz. İşin sorgularını başarılı saymak için bu yanıta dayanmayın. Belgelerden yolları ve filtreleri, rehberden tarih pencerelerini, anahtar sayfasından kayıt akışını inceleyin. Kalıcılık, değişmezlik, tam kapsam, belirli performans veya kesintisiz erişim garanti edilmez. Sonuçları aktarırken hangi koşullarla hangi sayfaların gerçekten alındığını belirtin; bunları canlı veri hattı olarak sunmayın.
