Tentukan unit pengamatan sebelum membaca hasil
Tulis keputusan yang dapat ditinjau: dari rekaman r/science yang diterima dan cocok dengan replication, mana yang membahas pengulangan studi? Gunakan rekaman sebagai unit dan pilih postingan, komentar, atau keduanya sebelum membaca hasil. Kueri memilih calon teks; pembacaan lokal menentukan kategorinya. Kecocokan kata tidak membuktikan keberhasilan replikasi hasil ilmiah.
Tulis pertanyaan riset, tipe rekaman, komunitas, periode, dan aturan penyertaan terlebih dahulu. Reddit API Labs adalah arsip historis independen, bukan layanan resmi Reddit atau data langsung. OAuth, operasi tulis, pemungutan suara, dan pesan pribadi tidak tersedia. Rekaman yang diambil bukan sampel acak seluruh pengguna. Metode yang terdokumentasi tidak berarti data selalu sama di masa depan. Menjalankan kode pada berkas lokal yang sama berbeda dari mengambil data baru melalui API. Nyatakan tindakan yang hendak diuji dan batas kesimpulan sebelum menafsirkan hasil.
Catat kueri yang benar-benar dijalankan
GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 adalah contoh awal, bukan jaminan tiga hasil. q menentukan teks, subreddit komunitas, dan limit jumlah maksimum. Pencarian replication tidak melakukan sampling acak. from dan to memakai YYYY-MM-DD dalam UTC, dengan to mencakup seluruh hari; kind menerima post atau comment. min_score hanya ambang skor, bukan kualitas, kepentingan, atau pengurutan. Jelaskan efek mengecualikan skor rendah pada pilihan data. Jika kondisi diubah setelah hasil dilihat, catat sebagai langkah eksperimen yang berbeda, bukan menyamarkannya sebagai kueri semula.
Saat mencoba replication crisis, tambahkan perubahan pada catatan kueri. q mencari title dan text dengan operator and dalam bidang yang cocok; bukan sekadar menggabungkan kata dari judul dengan kata lain dari isi. Pisahkan respons kedua rumusan. Tidak satu pun mencakup seluruh kosakata diskusi replikasi ilmiah.
Gunakan Authorization: Bearer YOUR_API_KEY atau X-API-Key: YOUR_API_KEY; keduanya valid untuk kunci arsip domain ini, bukan token OAuth Reddit. Simpan rahasia pada server dan keluarkan dari protokol serta log. /v1/posts untuk postingan, /v1/comments untuk komentar, dan id bukan filter daftar tersebut; /v1/item?id=... mengambil item yang diketahui. /v1/subreddits?prefix=... dapat dipakai menemukan komunitas, tetapi bukan daftar alfabetis menyeluruh atau hitungan global yang pasti. Catat kondisi dari permintaan yang benar-benar dijalankan, lalu kaitkan dengan respons yang diterima, bukan hasil contoh yang diasumsikan.
Beri anotasi tanpa menimpa teks asli
Buat tabel lokal berisi pengenal rekaman bila tersedia, kategori, dan alasan. Kategori awal dapat berupa pengulangan studi, replikasi biologis, dan konteks tidak cukup. Itu label Anda, bukan bidang API. Biarkan kasus ambigu menunggu peninjauan, dan simpan teks asli di samping versi yang disiapkan untuk analisis.
Simpan JSON mentah, waktu permintaan, halaman, kode status, dan hasil penyimpanan dalam lingkungan sendiri. Hash berkas yang dihitung secara lokal membantu memeriksa identitas berkas tersimpan, bukan versi atau sertifikat ketetapan server. Catat versi kode, dependensi, pembersihan, dan aturan klasifikasi. Jika analisis memakai langkah acak, dokumentasikan pengaturannya juga. Pemeriksaan dengan masukan lokal berbeda dari kueri arsip baru. Menyimpan kode serta data tidak dengan sendirinya menjamin kebenaran ilmiah atau keluaran identik di semua lingkungan. Jelaskan pula transformasi yang dilakukan setelah pengambilan.
Ubah satu hal dalam tiap perbandingan
Mulai dengan masukan tersimpan yang sama dan ubah hanya aturan anotasi. Jelaskan keputusan mana yang berubah serta alasannya. Pengambilan jarak jauh baru mendapat catatan tersendiri. Bila data dan aturan berubah bersamaan, selisih hitungan kategori tidak dapat dikaitkan hanya dengan salah satu perubahan.
Respons berupa rekaman datar; pengelompokan parent_id dan link_id bersifat pilihan untuk hubungan. Membaca atau menghitung tidak memerlukan pohon dan induk hilang tidak dipulihkan. Urutan dokumen bukan waktu, relevansi, atau skor. Batasnya 100 rekaman per permintaan dan 100 halaman per kueri. eq berarti total tepat, gte batas bawah, unknown atau null total tepercaya yang tidak diketahui. Total tepat tidak membuktikan semua hasil tersimpan. Pembagian tanggal serta deduplikasi tidak menjamin pengambilan lengkap atau unik. Sertakan halaman, alasan berhenti, dan bidang hilang dalam protokol.
Laporkan titik berhenti dan kasus yang belum jelas
Akhiri dengan parameter, halaman diterima, rekaman dipertahankan, pengecualian, dan makna yang belum terselesaikan. Nyatakan alasan berhenti serta versi aturan yang menghasilkan hitungan. Total yang tidak diketahui, konteks hilang, atau celah arsip tidak membuktikan bahwa komunitas tidak pernah membahas topik tersebut.
Pengambilan berhasil termasuk kosong memakai satu kredit; 1.000 keberhasilan berharga $1. Permintaan tidak valid tidak didebit dan kegagalan sistem hulu mengembalikan cadangan. Respons dapat hilang setelah server berhasil, lalu pengulangan berhasil dikenai kredit lagi. 400 untuk parameter, 401 kunci, 402 saldo, dan 429 laju; batasi percobaan. /v1/status publik tanpa biaya hanya menunjukkan cakupan statis serta respons HTTP, bukan pencarian, rekaman, kunci, atau saldo. Pengembalian kredit tidak membuktikan konsistensi data. Penyimpanan permanen dan kinerja tidak dijamin; gunakan data dengan mempertimbangkan hukum serta hak pihak ketiga.
