Masukan rute dan autentikasi
Alamat dasar adalah https://api.redditapihub.com. GET /v1/search mencari posting dan komentar; /v1/posts mengambil posting, sedangkan /v1/comments mengambil komentar. Ketiganya mengembalikan catatan datar, bukan merakit pohon percakapan. GET /v1/item?id=... meminta satu catatan yang pengenalnya diketahui. id hanya didukung pada item, bukan filter posts atau comments. Bentuk masukan yang sesuai untuk setiap rute secara terpisah dalam klien Anda.
GET /v1/subreddits?prefix=program&limit=3 mencari awal nama komunitas dan meminta paling banyak tiga hasil. prefix bukan pencarian q dalam isi posting. Hitungan komunitas tidak dijamin tepat secara global, dan urutan alfabetis tidak dijanjikan. Jangan menafsirkan daftar sebagai inventaris seluruh arsip. Jika nama dipakai untuk kueri data berikutnya, evaluasi kondisi dan respons permintaan itu sendiri. Adanya nama tidak membuktikan seluruh riwayatnya tersedia.
Pengambilan menerima Authorization: Bearer YOUR_API_KEY maupun X-API-Key: YOUR_API_KEY; pilih salah satu. Kunci asli harus disimpan pada konfigurasi rahasia server. Cookie Secure HttpOnly panel akun mempunyai fungsi sesi berbeda dan bukan pengganti header itu. Akun, kunci, serta saldo khusus redditapihub.com. Kunci merek lain tidak memberi akses pada akun yang sama di sini. Jangan memuat rahasia di URL atau kode browser.
Filter pencarian dan interpretasi respons
Kueri pencarian, posting, dan komentar mendukung q, subreddit, author, kind, from, to, min_score, limit, serta page. Nilai kind adalah post atau comment. Tanggal memakai YYYY-MM-DD berdasarkan UTC; hari to termasuk. min_score ialah ambang skor minimum, bukan pengurutan. parent_id dan link_id bukan filter kueri. Jangan menganggap rute item serta komunitas menerima semua kondisi pencarian yang sama atau dapat meminta percakapan lengkap melalui hubungan tersebut.
limit dan page menerima 1–100 pada kueri pencarian dan daftar posting atau komentar. Satu permintaan paling banyak 100 catatan dan satu kueri paling banyak 100 halaman. Setiap halaman diminta terpisah. Urutan dokumen arsip bukan waktu, relevansi, atau skor. Pengulangan halaman dan pembagian tanggal tidak menjamin semua hasil atau keunikan catatan. Lacak kondisi serta halaman yang disimpan oleh aplikasi Anda.
Respons API selalu menyajikan catatan datar yang sederhana dan tidak terstruktur sebagai pohon utuh. Meskipun bidang parent_id dan link_id dapat hadir dalam respons, pengelompokan oleh klien bersifat opsional. Tidak ada jaminan kelengkapan konteks percakapan atau garis silsilah komentar yang disediakan oleh server. Pengembang dapat melakukan pengelompokan lokal berdasarkan field yang tersedia tanpa asumsi bahwa data mencakup seluruh pohon diskusi secara utuh.
Total catatan dengan eq bersifat tepat, gte adalah batas bawah, dan unknown atau null berarti tidak ada total andal. Total bukan jumlah halaman dan angka tepat tidak membuktikan semua catatan sudah tersimpan. Membaca atau menghitung tidak membutuhkan pohon. Pengelompokan hubungan merupakan pilihan lokal untuk tujuan tertentu dan tidak memulihkan induk yang hilang. Jangan mengganti ketiadaan konteks dengan asumsi bahwa server sudah merangkai percakapan lengkap.
Status publik dan kesalahan
GET /v1/status tidak memerlukan kunci dan tidak memakai kredit. Respons menunjukkan cakupan layanan tetap serta aplikasi HTTP yang merespons. Sumber arsip, pencarian, keberadaan catatan, atau saldo tidak diperiksa. Karena itu, keberhasilan status bukan bukti bahwa rute data bekerja. Periksa HTTP dan isi setiap pengambilan dalam konteksnya sendiri serta bedakan hasil kosong berhasil dari kegagalan yang memerlukan tindakan berbeda.
HTTP 400 berarti bentuk atau nilai parameter tidak valid, HTTP 401 kunci hilang atau tidak valid, HTTP 402 saldo kurang, dan HTTP 429 batas laju. Perbaiki kondisi atau kunci; pada batas laju tunda pengiriman. Permintaan tidak valid tidak mendebit dan kegagalan sumber hulu mengembalikan cadangan kredit. Pengambilan berhasil, termasuk kosong, memakai satu kredit. Respons yang hilang di klien dapat mengikuti keberhasilan berbayar server; pengulangan berhasil berbiaya lagi.
