Daftar nama atau catatan konten?
Jika membangun pemilih komunitas, evaluasi /v1/subreddits terlebih dahulu. Contoh beranda https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3 memakai prefix untuk awal nama dan limit untuk maksimum hasil. Ini bukan kategori topik atau pencarian teks posting. Anda dapat memindahkan nama yang diterima ke daftar pilihan lokal, tetapi jangan menyajikannya sebagai inventaris seluruh Reddit maupun seluruh arsip yang lengkap.
Urutan alfabetis dan hitungan global tepat tidak dijamin pada keluaran komunitas. Pengurutan lokal boleh dilakukan, tetapi hanya mencakup nama yang diterima. Satu nama yang muncul tidak membuktikan semua posting dan komentarnya tersedia. Evaluasi respons kueri konten berikutnya secara terpisah. Hasil awalan yang kosong juga tidak membuktikan bahwa tidak ada komunitas seperti itu di seluruh Reddit. Batasi kesimpulan pada permintaan yang benar-benar dijalankan.
Reddit API Hub adalah arsip historis independen, bukan layanan resmi atau langsung Reddit. OAuth, tindakan tulis, suara, dan pesan tidak tersedia. Rute yang tampak sesuai tidak menjamin periode atau catatan tertentu dapat diperoleh. Tentukan sejak awal apakah tugas membutuhkan informasi terbaru atau catatan masa lalu. Pemilihan nama dan cakupan konten adalah dua pertanyaan berbeda yang memerlukan pemeriksaan tersendiri.
Pencarian, daftar menurut jenis, dan item
Gunakan /v1/search untuk mencari catatan posting dan komentar berdasarkan kondisi. Pilih /v1/posts jika hanya memerlukan posting dan /v1/comments jika hanya komentar. Rute-rute itu tidak menyediakan percakapan lengkap atau analitik otomatis. Periksa bidang pada respons nyata sebelum memetakannya ke skema aplikasi. Tentukan perilaku saat judul, teks, atau hubungan tidak tersedia; jangan mengisi konten yang tidak diterima menggunakan dugaan.
Untuk satu catatan dengan pengenal yang diketahui gunakan /v1/item?id=.... id bukan filter posts atau comments. Rute pencarian menerima q, subreddit, author, kind, serta from dan to dalam format UTC YYYY-MM-DD; hari to termasuk. kind bernilai post atau comment. min_score adalah ambang skor, bukan pengurutan. Jangan menyalin semua kondisi pencarian itu ke rute komunitas karena masukan tiap rute mempunyai tujuan berbeda.
Catatan datar tidak memerlukan pohon untuk dibaca, dihitung, atau dikodekan. Jika meneliti hubungan, pilih pengelompokan lokal dengan parent_id atau link_id yang tersedia; keduanya bukan filter kueri. Induk dan komentar yang hilang tidak kembali melalui proses itu. Jangan menyajikan daftar komentar sebagai percakapan lengkap atau daftar posting sebagai struktur yang sudah mencakup semua balasannya.
Batas hasil dan akses server
Filter min_score berfungsi hanya sebagai penyaring, bukan sebagai alat pengurutan skor. Urutan pengembalian data mengacu pada urutan dokumen arsip yang mungkin tidak berurutan secara kronologis atau berdasarkan relevansi. Memahami perilaku pengurutan ini membantu Anda mengelola ekspektasi terhadap hasil pencarian yang diterima oleh aplikasi Anda.
Kueri pencarian, posting, dan komentar dibatasi 100 catatan per permintaan dan 100 halaman per kueri. Setiap halaman diminta terpisah. Total eq berarti tepat, gte batas bawah, dan unknown atau null tidak ada total andal. Angka tepat tidak membuktikan semua catatan tersimpan. Pembagian tanggal tidak menjamin pengambilan menyeluruh maupun unik. Lacak apa yang diterima agar laporan aplikasi tidak melampaui cakupan hasilnya.
Simpan kunci pada server dan kirim Authorization: Bearer YOUR_API_KEY atau X-API-Key: YOUR_API_KEY. Cookie akun memiliki fungsi terpisah. /v1/status tanpa biaya hanya menunjukkan cakupan tetap dan respons HTTP, bukan memeriksa arsip, kunci, atau saldo. Perbaiki kondisi pada HTTP 400, kunci pada 401, saldo pada 402, dan tunda pengiriman pada 429. Jangan menggunakan satu pola pengulangan otomatis untuk semuanya.
Setiap pengambilan berhasil, termasuk kosong, memakai satu kredit. Permintaan tidak valid tidak mendebit; kegagalan sumber hulu mengembalikan cadangan. Server dapat berhasil sebelum respons hilang di klien dan pengulangan berhasil berbiaya lagi. Lacak halaman yang disimpan melalui catatan aplikasi. Dokumentasi memuat kontrak teknis, Harga anggaran, dan Dapatkan kunci API operasi akun. Pilihan rute yang benar tetap bukan jaminan cakupan arsip.
