Yeni istemci için yolları, filtreleri ve yanıtları eşleyin
GET yollarını, iki anahtar başlığını, UTC tarih filtrelerini ve sayfa sınırlarını öğrenin. eq, gte ve unknown ile HTTP hata durumlarını doğru yorumlayın.
İlk istek
İsteği sunucunuzdan gönderin ve API anahtarınızı gizli tutun.
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/posts
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/comments
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/item
id
GET
/v1/subreddits
prefix, limit
GET
/v1/status
—
Sorgu parametreleri
Parametre
Değer / tür / aralık
q
text
subreddit
keyword
author
keyword
kind
post | comment
from
ISO date
to
ISO date
min_score
integer
limit
1–100
page
1–100
id
item ID
prefix
subreddit prefix
Yollar ve anahtar başlıkları
Temel adres https://api.redditproxy.com üzerindedir. GET /v1/search gönderi ve yorum arar; /v1/posts gönderileri, /v1/comments yorumları getirir. GET /v1/item?id=... belirli bir kaydı kimliğiyle ister. id yalnızca item yolunda desteklenir; posts veya comments filtresi değildir. GET /v1/subreddits?prefix=... topluluk adlarının başlangıcına göre sorgular. limit ile istenen topluluk sayısını sınırlandırabilirsiniz; özet sayımların küresel olarak kesin olduğu garanti edilmez.
Veri alma için Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY kullanın. İki başlık da desteklenir. Buradaki Bearer değeri Reddit OAuth belirteciniz değil, redditproxy.com API anahtarınızdır. Hesap paneli Secure HttpOnly oturum çerezi kullanır ve bu çerez arşiv isteğinin anahtarı yerine geçmez. Anahtarları sunucuda saklayın; eski istemcinin gizli değerlerini yeni URL’ye sorgu parametresi olarak eklemeyin.
GET /v1/status herkese açık ve ücretsizdir. Sabit hizmet kapsamı açıklamasıyla HTTP uygulamasının yanıt verdiğini gösterir. Arşiv kaynağını, sorgu işleyişini, kayıt varlığını veya hesabın bakiyesini kontrol etmez. Bu yanıtı arşiv sağlığı testi olarak kullanmayın. Her veri isteğinin kendi HTTP durumunu ve içeriğini incelemek gerekir; durum yanıtı sonraki işlemin başarılı olacağını kanıtlamaz.
Parametreler ve düz kayıtlar
Arama, gönderi ve yorum sorgularında q, subreddit, author, kind, from, to, min_score, limit ve page desteklenir. kind değeri post veya comment olabilir. from ve to tarihlerini UTC esaslı YYYY-MM-DD biçiminde gönderin; to belirtilen günü dahil eder. min_score alt puan eşiğidir ve sonuçları puana göre sıralamaz. parent_id ve link_id sorgu filtreleri değildir; bunlarla bütün konuşmayı isteme özelliği yoktur.
limit 1–100, page 1–100 aralığındadır. Bir istek en fazla 100 kayıt, bir sorgu en fazla 100 sayfa ile sınırlıdır. Her sayfa ayrı bir istektir. Toplam kayıt sayısında eq kesin toplamı, gte alt sınırı, unknown veya null güvenilir toplamın bulunmadığını belirtir. Kesin toplam bile istemcinizin her kaydı kaydettiğini kanıtlamaz. Tarih dilimleri ve sayfa tekrarları eksiksiz veya tekrarsız toplama garantisi vermez.
Kayıtlar arşivdeki _doc sırasına göre döndürülür. Bu sıra, kronolojik, alakalı veya skora dayalı sıralamadan farklıdır. İsteğe bağlı olarak yerel gruplama yapılabilir ancak bu eksiksiz bir bütünlük anlamına gelmez. Arşiv doküman sırasının kronolojik olmadığı unutulmalı ve bu durum, verilerin işlenme biçimini etkileyebilir. Bu nedenle, veri analizlerinizde sıralama varsayımlarınızı buna göre düzenlemelisiniz.
Yanıtlar düz kayıtlardır. Okumak, sınıflandırmak veya saymak için konuşma ağacı gerekmez. İlişkileri incelemek isterseniz mevcut parent_id ya da link_id alanlarıyla isteğe bağlı yerel gruplama yapabilirsiniz. Alanlar her kayıtta bulunmayabilir ve eksik üst kayıtlar geri getirilemez. Eski istemcinin zorunlu alan beklentilerini denetleyin; mevcut olmayan bilgiyi sessizce varsayılan bir değerle değiştirmek yerine kendi uygulamanızın eksik veri kuralını kullanın.
Hata durumları ve kredi
HTTP 400 hatalı parametre biçimini veya değerini, HTTP 401 eksik ya da geçersiz anahtarı, HTTP 402 yetersiz bakiyeyi, HTTP 429 hız sınırını belirtir. Eski yeniden deneme döngüsünü aynen taşımayın. Parametre ve anahtar sorununu düzeltmeden tekrarlamak çözüm değildir; hız sınırında yeni gönderimi erteleyin. HTTP hata yanıtını, ağ bağlantısının kopmasından ayrı ele alın ve gizli başlıkları günlük kaydına yazmayın.
Başarılı veri alma, boş sonuç dahil bir kredi kullanır. Geçersiz istekten kredi düşülmez; üst kaynak hatasında ayrılan kredi geri verilir. İstemci yanıtı alamadığında sunucuda ücretli başarı gerçekleşmiş olabilir. Başarılı tekrar ayrı bir kredi tüketir. Kullanım hesabınızın yalnızca ekrandaki hata sayısından oluşmaması gerekir. Hesap, anahtar ve bakiye bu alana özeldir; başka markanın kredisi burada ortak bakiye sayılmaz.
