Hedef tablonuz hangi alanları gerçekten kullanabilir?

Reddit Extract ile küçük bir PostgreSQL yanıtını inceleyin. Başlık ve metni ayırın, eksik değerleri koruyun ve kendi alan eşleme kurallarınızı belirleyin.

API anahtarı al

İstek örneği

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3"

Yapay yanıt örneğinden bir bölüm

Yalnızca gösterim amaçlıdır; bunlar gerçek arşiv kayıtları değildir.

{
  "data": [
    {
      "kind": "post",
      "subreddit": "PostgreSQL",
      "title": "Demo: checking an index",
      "text": "Fictional example for mapping available fields."
    }
  ]
}

Yalnızca data gösterilir. Döndürülen alanlar değişebilir; bu, yanıtın tamamı değildir.

PostgreSQL sorgusuyla hedef satırı sınayın

PostgreSQL için hazırladığınız tablo gövde metni isterken alınan bir kayıt yalnızca işe yarar bir başlık içerebilir. Büyük bir çekmeye başlamadan bu durumu nasıl işleyeceğinizi belirleyin. Küçük index araması, hangi değerin kopyalanacağına, hangisinin eksik kalacağına ve hangi kaydın incelemeye ayrılacağına karar vermek içindir.

Reddit Extract bağımsız bir geçmiş Reddit arşivi API’sidir; resmî veya Reddit ile bağlantılı hizmet değildir ve canlı veri sunmaz. Veri dönüştürme geliştiricileri, kendi çıktı tablolarını tasarlamadan önce gerçekten dönen alanları inceleyebilir. Arşiv bir kayıt için her alanın bulunacağını, sabit türler döneceğini veya gelecekte aynı yanıtın alınacağını garanti etmez. Tutarlı hedef şema, sizin uygulamanızda tanımladığınız bir sözleşmedir.

Örnek GET adresi https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3 şeklindedir. q=index metin aramasını, subreddit=PostgreSQL topluluk filtresini, limit=3 ise en fazla üç kayıt isteğini belirtir. Daha az kayıt veya boş sonuç dönebilir. Authorization: Bearer YOUR_API_KEY ya da X-API-Key: YOUR_API_KEY başlığını kullanın. Yer tutucuyu gerçek anahtarla yalnızca güvenilir sunucunuzda değiştirin; herkese açık dönüştürme tarifine sır eklemeyin.

Başlık, gövde metninin kendiliğinden yerine geçmez

Varsa title ve text değerlerini önce ayrı inceleyin. Sonradan tek sütunda birleştirirseniz bunun türetilmiş içerik olduğunu ve değerin hangi alandan geldiğini kaydedin. index sözcüğünün başlıkta eşleşmesi, gövde metninde de bulunduğunu göstermez. Başlığı yedek değer olarak kullanmak uygulamanızın kararıdır; onu kaydın özgün gövde metni gibi sunmayın.

Yanıttaki her kaydı ayrı inceleyin. Kimlik, tür, metin ve zaman alanları gerçekten varsa bunları hedef sütunlara eşleyin; olmayan bir alanı örnekte varmış gibi göstermeyin. Aynı küçük sayfa, alan seçimini sınamak için yeterli bir başlangıç olabilir ancak bütün arşivin şemasını kanıtlamaz. Bu sayfa canlı bir sonuç veya uydurulmuş PostgreSQL gönderisini gerçek veri olarak sunmaz.

Eksik değer için açık bir karar verin

Hedefinizde hangi alanların zorunlu, hangilerinin isteğe bağlı olduğunu yazın. Alanın hiç gelmemesi, açık null değeri, boş metin ve sıfır birbirinden farklı durumlardır. Hepsini otomatik olarak boş metne çevirmek kaynak bilgisini kaybettirir. Dönüşüm sırasında kaynak alan adını, gözlenen türü ve uyguladığınız kuralı kaydedin; hedefte null kullanmanız, kaynakta null bulunduğu anlamına gelmesin.

Sayı beklediğiniz yerde metin gelirse sessizce tahmin yürütmek yerine bir hata kaydı veya ayrı inceleme kuyruğu oluşturabilirsiniz. Kimlikleri aritmetik değer gibi kullanmayın; biçimlerini koruyun. Zaman alanı varsa birimini doğrulamadan tarih üretmeyin. Bu doğrulamalar yerel işlem adımlarıdır; API sizin adınıza tür dönüştürme, şema dışa aktarma, içerik düzeltme veya veri kalitesi değerlendirmesi yapmaz.

Konuşma üretmeden ilişkileri koruyun

Filtreleme seçenekleri, sorgu parametreleri aracılığıyla esnek bir şekilde uygulanabilir. min_score parametresi yalnızca bir filtre olarak çalışır, sonuçları skorlarına göre sıralamaz. Bu detay, arama sonuçlarının yorumlanması sırasında dikkat edilmesi gereken önemli bir ayrıntıdır. İstenen veri kümesini daraltmak için yazar, subreddit veya tarih aralıkları kullanılabilir. Tarihler UTC esaslı YYYY-MM-DD biçimindedir ve to son günün tamamını içerir. Filtre değişikliği farklı bir seçim oluşturur; bunu aynı kaynak sayfanın yalnızca başka sunumu diye kaydetmeyin.

Yanıtlar düz kayıtlardır; parent_id ve link_id varsa yerel ilişkilendirme isteğe bağlıdır ve eksik ebeveynleri tamamlamaz. _doc belge sırası zaman, ilgi veya puan sırası değildir. İstek başına 100 kayıt ve sorgu başına 100 sayfa üst sınırı vardır. Sayfalama, tarihleri bölme veya tekrar ayıklama tam arşiv aktarımını ya da benzersiz sonuçları garanti etmez.

İncelemeyi uygulanabilir alan kurallarıyla bitirin

Başarılı her çekme, boş sonuç dahil, bir kredidir. Başarılı 1.000 istek $1; minimum $50 yükleme 50.000 ücretli kredidir. Abonelik yoktur, ücretli krediler sona ermez. 100 deneme kredisi ağ genelindeki kötüye kullanım önleme uygunluğuna bağlıdır. Yerel kaydı yeniden dönüştürmek yeni API isteği değildir; aynı sayfayı sunucudan başarıyla tekrar almak yeniden ücretlendirilir.

Bu incelemenin çıktısı kısa bir kural listesi olsun: her sütunun kaynağı, kabul edilen durumlar ve reddedilen kayıtların nasıl tutulacağı. Rehber bu kararları saklanan yanıt üzerinde sınamanızı sağlar. İstek parametreleri için belgelere, sunucudan ilk çağrıyı hazırlamak için anahtar sayfasına geçin.