Kimlik Doğrulama ve Hesap Yapılandırması
Veri çekme isteklerinde Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY kullanılabilir. İkisi de desteklenir. /v1/status anahtar gerektirmeyen ücretsiz bir yoldur. Hesap oluşturmak e-posta ve 12–72 UTF-8 baytlık parola gerektirir; Google ile giriş veya cüzdan bağlantısı yoktur. Anahtar ödeme öncesinde bir kez gösterilir. Gerçek anahtarı halka açık kodda, URL içinde veya paylaşılan araştırma dosyasında tutmayın.
API anahtarları ve hesap bakiyeleri her etki alanına özeldir. Bu, aynı etki alanı ağında farklı bir siteden alınan bir anahtarın genel geçer bir ağ anahtarı olmadığı anlamına gelir. Kullanıcılar oturum açtıktan sonra, şifrelerini doğrulayarak API anahtarlarını yenileyebilirler. Anahtar yenilendiğinde, eski anahtar hemen geçersiz kılınır. Sistemde e-posta yoluyla otomatik anahtar teslimatı veya şifre sıfırlama özelliği bulunmamaktadır; bu nedenle anahtar güvenliği tamamen kullanıcıya aittir.
Hesap oturumu Secure HttpOnly çerezle yönetilir. localStorage içindeki kullanıcı ve fatura kimlikleri, kaydedilmiş faturayı geri getirmek içindir; ham API anahtarı burada tutulmaz. Sunucu parola ve anahtar hash değerlerini, anahtar öneklerini ve kullanım kayıtlarını saklar. Hesap panelindeki oturum ile API anahtarı başlığı ayrı doğrulama yöntemleridir. Anahtar ve bakiye yalnızca redditpostsapi.com için geçerlidir, diğer markalarla ortak değildir.
Uç Noktalar, Filtreler ve Veri Yapısı
Arşiv verilerine erişim için mevcut olan uç noktalar arasında /v1/search, /v1/posts, /v1/comments, /v1/item, /v1/subreddits ve /v1/status bulunmaktadır. /v1/search ve /v1/posts uç noktaları, 'q' gibi genel arama parametrelerini kabul ederken, /v1/subreddits önek aramasını destekler. Her bir istek, veri geri çekme limitlerine tabidir; en fazla bir istekte 100 kayıt ve bir sorguda 100 sayfa getirilebilir. Bu sınırlamalar, tüm arşivin tek seferde eksiksiz olarak dışa aktarılabileceği anlamına gelmez.
Aramada q, subreddit, author, kind, from, to, min_score, limit ve page desteklenir. kind için post veya comment kullanılır. from ve to, UTC takviminde YYYY-MM-DD biçimindedir; to günü dahildir. min_score yalnızca filtreler, sıralamaz. /v1/item için id gereklidir; /v1/posts ve /v1/comments için id kullanılmaz. /v1/subreddits topluluk adlarını prefix ve limit ile keşfeder; sayımları küresel olarak kesin olmayabilir.
API yanıtları düz JSON kayıtları içerir; sunucu tamamlanmış konuşma ağaçları oluşturmaz. parent_id veya link_id varsa istemci bunlarla yerel gruplama yapabilir. Bu alanlar istek filtresi değildir ve bütün üst kayıtların veya konuşma bağlamının bulunduğu garanti edilmez. Tarih veya metin gibi alanların varlığını da yanıt üzerinde kontrol edin. Eksik alanı kendiliğinden tamamlamak yerine analiz dışı bırakma veya yerel işleme kararınızı açıkça kaydedin.
Hatalar, Ödemeler ve Sayfalandırma
HTTP 400 geçersiz istek, 401 eksik veya geçersiz anahtar, 402 yetersiz bakiye, 429 hız sınırı anlamına gelir. Bu reddedilen istekler kredi düşürmez; kaynak sistemde başarısız veri çekmenin rezervi iade edilir. Başarılı boş sonuç bir kredi tüketir. İstemci yanıtı alamamış olsa bile sunucu ücretli başarıya ulaşmış olabilir. Başarılı tekrar yeni kredi tüketir. /v1/status ücretsizdir ama arama sağlığını veya kapsamı doğrulamaz.
Faturalandırma, başarılı geri getirme istekleri başına bir kredi maliyetiyle çalışır. Kredi satın alımları için minimum tutar 50 ABD Doları'dır. Kullanıcılar, ödeme doğrulama sürecini tamamlamadan önce isteğe bağlı 100 kredi deneme sürümünden yararlanabilirler. Bu deneme sürümü, ağ çapındaki kötüye kullanım limitlerine tabidir. Ödeme yapmak için kullanıcılar, sunucu tarafından oluşturulan faturadaki adresi ve tutarı kullanarak USDT TRC20 veya USDC ERC20 ile ödeme yapmalıdır.
Sayfalama ilişkisinde eq kesin toplamı, gte alt sınırı, unknown ise güvenilir toplamın bilinmediğini gösterir; toplam null olabilir. Bunlar eşleşen kayıt sayısıyla ilgilidir, toplam sayfa sayısıyla değil. Alt sınır kesin sayım değildir; kesin toplam da istemcinin bütün eşleşmeleri kaydettiğini kanıtlamaz. Her istekte en fazla 100 kayıt, sorguda en fazla 100 sayfa istenebilir. Kaydedilen yanıtları ve yerel ilerleme notlarını bu belirsizlikle birlikte değerlendirin.
