Sunucu tarafındaki kimlik bilgisi sınırı
Temel adres https://api.redditapigateway.com üzerindedir. /v1/search arama, /v1/posts gönderi, /v1/comments yorum listeleri için GET isteği kabul eder. /v1/item?id=... bilinen bir öğe kimliğiyle kullanılır; /v1/subreddits?prefix=... topluluk adlarını önekle daraltır. /v1/status ise açık durum yoludur. Bunlar bağımsız geçmiş arşivine ait yollardır; resmî Reddit API’sinin bütün yollarını veya davranışlarını taklit eden bir aktarım hizmeti değildir. Yazma, OAuth ve canlı akış işlevleri bulunmaz.
Veri çekme isteğinde Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY başlıklarından birini kullanın. İki biçim de geçerlidir ve aynı alan adına ait anahtarı taşır. Bearer yerine Reddit OAuth belirteci göndermeyin. Hesap panelinin Secure HttpOnly oturum çerezi ayrı bir kimlik doğrulama katmanıdır; API anahtarı hesap parolası veya ödeme yetkisi değildir. Ürününüzün sunucusu anahtarı eklemeden önce kendi kullanıcısının yetkisini ve gönderilecek sorgunun kapsamını denetlemelidir.
Başlangıç için https://api.redditapigateway.com/v1/search?q=onboarding&subreddit=SaaS&limit=3 isteğinin yolunu ve parametrelerini inceleyin. Yer tutucu anahtarı yalnızca çalıştırma ortamında gerçek değerle değiştirin; kod deposuna veya istemci paketine yazmayın. Bu örnekte sonuç uydurulmaz ve eşleşen kayıt bulunması garanti edilmez. İki başlığı ayrı ayrı test ederseniz iki başarılı istek iki kredi tüketir. Ürünün yerel analiz adımını, yeni veri çekme adımından ayrı izleyin.
Filtreler, sayfalar ve kayıt ilişkileri
Arama, gönderi ve yorum yollarının filtreleri q, subreddit, author, kind, from, to, min_score, limit ve page alanlarıdır. kind için post veya comment kullanılır. Tarihler UTC esaslı YYYY-MM-DD biçimindedir; to belirtilen günün tamamını kapsar. min_score en düşük puan eşiğidir, sıralama komutu değildir. id yalnızca /v1/item içindir; /v1/posts veya /v1/comments üzerinde kimlik filtresi olarak kullanılamaz. parent_id ve link_id yanıt alanları olabilir ancak sorgu parametresi değildir.
İstek başına en çok 100 kayıt ve sorgu başına en çok 100 sayfa vardır. Her sayfa ayrı bir istek ve başarı halinde ayrı maliyettir. Belge sırası zaman, ilgi veya puan sırası değildir. eq kesin kayıt toplamını, gte alt sınırı, unknown veya null güvenilir toplamın bilinmediğini ifade eder. Toplamın birimi sayfa değil kayıttır. Sayfa döngüsü veya tarihleri bölmek, eksiksiz ve tekrarsız veri toplandığını tek başına göstermez.
Yanıt düz kayıtlardan oluşur; sunucu konuşma ağacı oluşturmaz. İlişki çözümlemesi gerekiyorsa dönen parent_id ve link_id alanlarını yerel olarak gruplayabilirsiniz. Basit okuma, etiketleme veya sayım için bu işlem zorunlu değildir. Eksik ebeveynler ve yorumlar gruplamayla geri kazanılmaz. Topluluk aramasını eksiksiz alfabetik dizin veya sayımları tüm arşivin kesin miktarı olarak yorumlamayın. Ürün raporunda sorgu koşullarıyla gerçekten alınan kayıtların sınırını birlikte tutun.
Hata ve kullanım kaydı
400 durumunda desteklenmeyen parametreyi, yanlış değeri ve tarih biçimini düzeltin. 401 eksik veya geçersiz anahtarı, 402 yetersiz krediyi, 429 istek sıklığı sınırını belirtir. Bu nedenler farklı müdahaleler gerektirir. Anahtar yenilendiyse eski değer hemen geçersizdir; sunucu yapılandırmanızda kalmış olabilir. Bakiyeyi yalnızca bu alan adındaki hesapla karşılaştırın. Sıklık sınırına karşı çağrıları azaltın ve beklemeli, sınırlı tekrar kullanın; farklı hesaplarla sınırı aşmayı denemeyin.
Her başarılı veri çekme isteği, boş sonuç dahil, bir kredidir. Geçersiz istekler kredi düşürmez, üst sistem hatalarının rezervasyonları geri verilir. İstemci yanıtı alamadığında sunucu işlemi tamamlamış olabilir; başarılı tekrar yeni bir kredi tüketebilir. Bu nedenle hata günlüğü ile yerel kayıt sonucunu ayrı izleyin. Anahtarı hata mesajına veya gözlemleme sistemine eklemeyin. Salt okunur erişim, aynı yanıtı ya da ücretsiz tekrarı garanti etmez.
/v1/status kimlik doğrulamasız ve ücretlendirilmeden statik hizmet kapsamını sunar. HTTP uygulamasının yanıt verdiğini göstermek arşiv deposunun sağlığını, belirli bir kaydı, anahtar geçerliliğini veya bakiyeyi doğrulamaz. Bu kontrolü gerçek sorgunun yerine koymayın. Ürününüzün kullanıcı kotası ve kayıt işleme durumu kendi altyapınızda tutulabilir; API bunları sizin adınıza tanımlamaz. Yayına alınan ürün açıklamalarında arşivin kapsam, değişmezlik, kalıcılık ve performans sınırlarını saklamayın.
