Pengantar Rute dan Struktur Data
Arsip Reddit independen ini menyediakan kumpulan rute API yang dirancang khusus untuk memungkinkan pengembang mengotomatisasi penelusuran konten historis. Anda dapat mengakses endpoint seperti /v1/search, /v1/posts, /v1/comments, dan /v1/item untuk mengambil data yang telah diarsipkan sebelumnya. Setiap rute memiliki tujuan spesifik untuk memastikan pengambilan data yang terarah dan efisien tanpa ketergantungan pada server live Reddit saat ini.
Respons yang dikembalikan oleh API berbentuk rekaman datar, bukan pohon utas yang disusun oleh server. Hal ini berarti data yang dikembalikan tidak secara otomatis menyertakan konteks percakapan lengkap atau struktur induk. Jika field parent_id dan link_id hadir dalam rekaman, klien dapat mengelompokkannya secara lokal. Namun, tidak ada jaminan kelengkapan atau jaminan pohon percakapan lengkap dari sisi server.
Data yang dikembalikan tidak menjamin urutan kronologis atau relevansi berdasarkan skor. Urutan dokumen dalam arsip mengacu pada urutan _doc, yang merupakan urutan internal arsip itu sendiri. Hal ini penting untuk diketahui oleh pengembang yang mengandalkan urutan waktu atau skor tertentu untuk memproses data. Struktur data yang datar memungkinkan fleksibilitas pemrosesan di sisi klien.
Filter, Batasan, dan Parameter Pencarian
Parameter filter memungkinkan Anda membatasi hasil pencarian dengan presisi tinggi. Anda dapat menggunakan parameter q untuk kata kunci, subreddit untuk subreddit tertentu, author untuk pengguna, dan kind untuk menentukan jenis post atau comment. Tanggal from dan to memakai YYYY-MM-DD dalam UTC, termasuk hari to. Pencarian q memeriksa title dan text; beberapa kata digabung dengan AND di dalam kolom yang cocok. Parameter min_score bertindak hanya sebagai filter, bukan sebagai kontrol pengurutan skor, sehingga tidak mempengaruhi urutan hasil yang dikembalikan.
Maksimum yang dapat diminta per permintaan adalah 100 rekaman, dan Anda dapat menavigasi hingga 100 halaman. Penting untuk dicatat bahwa iterasi halaman yang dibatasi tidak menjamin cakupan lengkap atau pengambilan menyeluruh dari seluruh arsip. Total dapat berupa hitungan tepat (eq), batas bawah (gte), atau tidak diketahui (unknown/null), sehingga Anda tidak dapat mengasumsikan bahwa Anda telah menemukan semua rekaman yang cocok hanya dengan mengulang halaman.
Untuk endpoint /v1/posts dan /v1/comments, parameter id tidak diperlukan. Id hanya diperlukan khusus untuk endpoint /v1/item. Subreddits mendukung pencarian prefix untuk pencarian yang lebih dinamis. Pastikan untuk membatasi jumlah record dan halaman agar tetap dalam batas yang diizinkan. Parameter di luar daftar yang didukung ditolak, bukan diterapkan sebagai filter tambahan.
Kode Kesalahan, Autentikasi, dan Tagihan
API menggunakan kode status HTTP ASCII literal untuk melaporkan kesalahan dan status. Kode 401 menunjukkan kunci yang tidak valid atau hilang, 402 menunjukkan kredit yang tidak cukup, dan 429 menunjukkan bahwa batas kecepatan telah terlampaui. Penting untuk menangani kode ini dengan tepat dalam alur kerja otomasi Anda. Kegagalan sumber mengembalikan reservasi ke saldo pengguna; permintaan tidak valid tidak mendebit kredit. Jika klien kehilangan respons setelah server berhasil, kredit mungkin sudah terpakai. Percobaan ulang yang berhasil memakai kredit lain. Kode 400 menunjukkan parameter tidak valid.
Autentikasi dilakukan menggunakan kunci API yang ditampilkan sekali tepat setelah pendaftaran, sebelum pembayaran. Permintaan pengambilan dapat memakai Authorization: Bearer atau X-API-Key. Kunci ini khusus untuk akun pada apireddit.cc dan tidak dapat dipindahkan ke situs lain. Jika kunci hilang, Anda dapat membuat ulang kunci setelah mengonfirmasi kata sandi. Tagihan dihitung berdasarkan permintaan pengambilan yang berhasil, dengan biaya satu kredit per permintaan. Bahkan hasil kosong tetap dikenakan biaya satu kredit.
Transaksi pembayaran menggunakan USDT TRC20 atau USDC ERC20 Ethereum mainnet. Gunakan hanya alamat penerimaan dan jumlah tepat yang ditampilkan pada invoice server. Kredit berbayar tidak kedaluwarsa, dan saldo tidak dibagikan antarsitus dalam jaringan. /v1/status tidak dikenai biaya, tetapi hanya memberikan keterangan statis, bukan pemeriksaan kesehatan pencarian. Pastikan untuk memantau batas kecepatan dan manajemen kredit untuk menjaga kelancaran alur kerja otomasi Anda tanpa gangguan yang tidak perlu.
