Dasar Arsitektur Arsip Independen
Reddit Posts API adalah akses baca ke arsip historis independen, bukan sumber langsung atau layanan resmi Reddit. Tidak ada jaminan akses stabil, cakupan tahun tertentu, atau hasil yang tidak berubah. Susun penelitian berdasarkan respons yang benar-benar diperoleh. Simpan pilihan filter, respons mentah, dan versi analisis lokal agar proses dapat diperiksa kembali; itu tidak menjamin pencarian yang diulang nanti menghasilkan data yang identik.
Contoh https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3 memilih komunitas, ambang skor, dan batas tiga catatan. Ini tidak menyaring peralatan secara khusus atau membuktikan tiga catatan tersedia. Analis perlu membaca teks yang ada untuk memilih diskusi peralatan dan mencatat alasan pengecualian. API tidak memverifikasi kebenaran isi, mengesahkan teks sebagai bersih, atau menghitung sentimen. Setiap kesimpulan harus sesuai dengan sampel yang dianalisis.
Authorization: Bearer YOUR_API_KEY atau X-API-Key: YOUR_API_KEY dapat dipakai untuk pengambilan. Kunci ditampilkan sekali saat pendaftaran sebelum pembayaran dan harus disimpan privat. Harga bergantung pada permintaan berhasil, bukan jumlah catatan: $1 per 1000 permintaan, satu kredit per keberhasilan termasuk kosong. Kunci dan saldo hanya berlaku pada domain ini. Jangan memasukkan rahasia ke dalam manifest pengambilan atau berkas analisis yang akan dibagikan.
Penetapan Jendela Tanggal dan Pengurutan Lokal
Tanggal merupakan filter opsional. Gunakan from dan to dalam YYYY-MM-DD UTC; tanggal to termasuk dalam rentang. Contoh from=2020-05-01&to=2020-05-31 hanya menjelaskan format batas, bukan klaim ketersediaan arsip pada periode tersebut. Untuk rentang berikutnya, mulai 2020-06-01 agar hari terakhir tidak dipakai dua kali. Filter ini bekerja pada hari kalender, bukan pilihan jam atau menit. Catat pemetaan ke UTC jika analisis Anda memakai zona waktu lokal.
Setiap permintaan dibatasi 100 catatan dan setiap kueri 100 halaman. Simpan halaman sebelum memajukan penanda kemajuan lokal. eq berarti total eksak, gte batas bawah, unknown tidak diketahui dan total dapat null. Total ini adalah catatan cocok, bukan jumlah halaman. Bahkan total eksak tidak membuktikan semuanya telah disimpan. Membagi periode atau mengulang halaman tidak menjamin pengambilan lengkap maupun bebas duplikasi dari sumber yang dapat berubah.
min_score menyaring skor minimum, bukan panjang teks atau urutan popularitas. Hasil mengikuti urutan dokumen arsip, bukan waktu atau relevansi. Jika bidang waktu tersedia dan dapat ditafsirkan, urutkan sampel lokal berdasarkan bidang tersebut. Pengelompokan hubungan saja tidak membuat urutan kronologis, dan pengurutan lokal tidak memulihkan catatan yang tidak diperoleh. Tulis aturan untuk waktu hilang, duplikasi, dan teks yang dikeluarkan sebelum menafsirkan pola dalam sampel.
Ekonomi Kredit dan Pemrosesan Data
Permintaan tidak valid tidak mendebit kredit; kegagalan sumber data mengembalikan cadangan. Klien yang kehilangan respons tidak tahu apakah server sudah berhasil dan menagih satu kredit. Pengulangan berhasil memakai kredit baru. HTTP 400 memerlukan koreksi parameter, 401 pemeriksaan kunci, 402 keputusan tentang saldo, dan 429 penundaan. Lihat halaman harga untuk anggaran yang mencakup hasil kosong serta pengulangan, bukan hanya jumlah baris yang diinginkan.
/v1/status gratis hanya menunjukkan penjelasan statis dan respons HTTP; tidak membuktikan pencarian sehat atau postingan tertentu tersedia. Respons datar juga bukan pohon percakapan lengkap. Jika parent_id atau link_id ada, Anda dapat mengelompokkan secara lokal, tetapi bidang itu bukan filter kueri dan catatan induk dapat hilang. Jangan melengkapi konteks dengan dugaan. Tandai keterbatasan ini saat memakai kutipan untuk menilai pembahasan peralatan.
Untuk satu catatan yang diketahui, gunakan /v1/item dengan id; /v1/posts dan /v1/comments tidak memakai id pada daftar. /v1/subreddits memakai prefix untuk nama komunitas, tanpa jaminan hitungan global eksak. Simpan metode pemilihan sampel bersama respons. Jika pembayaran diperlukan, buat faktur setelah masuk dan kirim hash transaksi untuk verifikasi server. Tidak ada layanan investigasi pembayaran manual yang dijanjikan; ikuti instruksi faktur saat ini dan gunakan panel pada halaman kunci untuk penggantian kredensial.
