Neyin gözlem sayılacağını önceden belirleyin
İncelenebilir bir karar yazın: replication ile eşleşen r/science kayıtlarından hangileri bir çalışmanın tekrarını tartışıyor? Gözlem birimi kayıt olsun; gönderi, yorum veya ikisini de kullanma kararını önceden verin. Sorgu aday metinleri seçer, kategoriyi yerel okuma belirler. Sözcük eşleşmesi bilimsel sonucun başarıyla tekrarlandığını kanıtlamaz.
Önce araştırma sorusunu, kayıt türünü, topluluğu, dönemi ve dahil etme kurallarını yazın. Reddit API Labs bağımsız geçmiş arşividir; resmî Reddit hizmeti ve canlı veri değildir. OAuth, yazma, oylama ve mesajlaşma yoktur. Erişilen kayıtlar bütün platformu veya kullanıcıları temsil eden rastgele örneklem değildir. Tekrarlanabilir bir yöntem açıklaması, verinin gelecekte hep aynı kalacağı anlamına gelmez. Aynı kaydedilmiş veriyle analiz kodunu yeniden çalıştırmak, API’den yeniden veri çekmekten farklıdır. Protokolde hangi işlemi denediğinizi açıkça ayırın.
Gerçekte çalıştırılan sorguyu kaydedin
GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 başlangıç örneğidir; üç sonuç garantisi yoktur. q metin koşulu, subreddit topluluk, limit azami kayıt sayısıdır. replication araması rastgele örnekleme yapmaz. Tarih kullanıyorsanız from ve to UTC YYYY-MM-DD’dir, to bütün günü içerir; kind post veya comment olur. min_score minimum puan filtresidir, kalite veya önem testi ve sıralama değildir. Bu filtreyle dışlanan kayıtların seçki üzerindeki etkisini yazın. Koşulları sonradan değiştirirseniz bunu ayrı deney adımı olarak kaydedin.
replication crisis denemesi için sorgu günlüğüne bir değişiklik ekleyin. q, title ve text üzerinde eşleşen alan içinde and ile çalışır; bir başlıktaki sözcüğü gövdedeki başka bir sözcükle basitçe birleştirmez. İki ifadenin yanıtlarını ayrı saklayın. Hiçbiri bilimsel tekrar tartışmalarının bütün sözcük dağarcığını kapsamaz.
Authorization: Bearer YOUR_API_KEY veya X-API-Key: YOUR_API_KEY kullanın; ikisi de bu alan adının arşiv anahtarını taşır, Reddit OAuth belirteci değildir. Gerçek sırrı sunucuda tutup protokolden ve günlükten çıkarın. /v1/posts gönderi, /v1/comments yorum içindir; id bu listelerin filtresi değildir, /v1/item?id=... bilinen tek öğe içindir. /v1/subreddits?prefix=... topluluk keşfinde kullanılabilir fakat eksiksiz alfabetik liste veya kesin küresel sayım değildir. İstek koşullarını örnek yanıttan değil gerçekten çalıştırdığınız çağrıdan kaydedin.
Özgün metni değiştirmeden etiketleyin
Yerel tabloya varsa kayıt kimliğini, kategoriyi ve gerekçeyi yazın. İlk kategoriler çalışma tekrarı, biyolojik replikasyon ve yetersiz bağlam olabilir. Bunlar API alanları değil sizin etiketlerinizdir. Belirsiz kayıtları zorla sınıflandırmak yerine incelemeye bırakın; özgün metni analiz için hazırlanan sürümden ayrı koruyun.
Özgün JSON’u, istek zamanını, sayfaları, durum kodlarını ve yerel kayıt sonucunu kendi ortamınızda saklayabilirsiniz. Kendi hesapladığınız dosya karması, koruduğunuz dosyanın kimliğini denetlemeye yardımcı olur; sunucu tarafından verilmiş sürüm veya değişmezlik belgesi değildir. Kod sürümünü, bağımlılıkları, temizleme ve sınıflandırma adımlarını yazın. Rastlantısal analiz adımı varsa kullanılan ayarları da belgeleyin. Yerel girdiye dayalı kontrol yeni arşiv sorgusundan ayrıdır; kayıt ve kod tutulması bilimsel sonucun doğruluğunu veya bütün ortamlarda aynı çıktıyı kendiliğinden garanti etmez.
Bir karşılaştırmada tek koşulu değiştirin
Önce saklanan girdiyi sabit tutup yalnızca etiketleme kuralını değiştirin. Hangi kararların neden değiştiğini açıklayın. Yeni uzak veri çekimine ayrı bir çalışma kaydı açın. Veri ve kurallar birlikte değişirse kategori sayılarındaki farkı tek başına bunlardan birine bağlayamazsınız.
Yanıt düz kayıttır; parent_id ve link_id ile ilişki gruplaması isteğe bağlıdır. Okumak ve saymak için ağaç gerekmez, eksik ebeveynler geri gelmez. Belge sırası zaman, ilgi veya puan sırası değildir. İstek başına 100 kayıt, sorgu başına 100 sayfa sınırı vardır. eq kesin toplam, gte alt sınır, unknown veya null güvenilir toplamın bilinmediğidir. Kesin sayı hepsinin alındığını kanıtlamaz. Tarih bölme ve tekrar ayıklama tam veya tekrarsız çıkarım garantisi değildir. Alınan sayfaları, durma nedenini ve eksik alanları protokole ekleyin.
Durma nedenini ve açık vakaları raporlayın
Son kayda parametreleri, alınan sayfaları, korunan kayıtları, dışlamaları ve çözülemeyen anlamları ekleyin. Neden durduğunuzu ve sayımları hangi kural sürümünün ürettiğini belirtin. Bilinmeyen toplamı, eksik bağlamı veya arşiv boşluğunu topluluğun bu konuyu hiç tartışmadığı biçiminde yorumlamayın.
Başarılı çekme boş sonuç dahil bir kredidir; 1.000 başarı $1’dir. Geçersiz istekler kredi düşürmez, üst sistem hataları rezervasyonları geri verir. Yanıt kaybından önce sunucu başarılı olabilir ve başarılı tekrar ek kredi tüketebilir. 400 parametre, 401 anahtar, 402 bakiye, 429 sıklık kontrolüdür; tekrar sayısını sınırlayın. /v1/status açık ve ücretsizdir ama statik kapsam ve HTTP yanıtı dışında arama, kayıt, anahtar veya bakiye testi değildir. Kredi iadesi veri tutarlılığını kanıtlamaz. Kalıcılık ve performans garanti edilmez; verinin kullanımında hukuku ve üçüncü taraf haklarını gözetin.
