Rute dan kredensial
Host pengambilan adalah https://api.redditapicloud.com. GET /v1/search untuk pencarian, /v1/posts untuk postingan, dan /v1/comments untuk komentar. /v1/item?id=... mengambil item yang pengenalnya diketahui; /v1/subreddits?prefix=... mencari nama komunitas berdasarkan awalan. /v1/status mengungkap cakupan statis. Arsip historis independen ini bukan layanan resmi Reddit dan tidak menyediakan data langsung, OAuth, operasi tulis, pemungutan suara, atau pesan pribadi. Anda tidak perlu menjalankan Elasticsearch untuk memanggil arsip, tetapi akses pengguna dan tampilan hasil tetap dikelola aplikasi Anda.
Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY valid. Nilainya kunci arsip domain ini, bukan token OAuth Reddit. Tambahkan nilai asli pada server, bukan kode publik, paket browser, atau log. Cookie sesi Secure HttpOnly panel terpisah. Akun, kunci, dan saldo tidak dibagikan ke merek lain. Contoh https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3 tidak menjamin tiga hasil. Server produk perlu memeriksa hak pengguna dan hanya meneruskan permintaan yang diizinkan; penyimpanan kunci sendiri bukan kontrol akses yang lengkap.
Filter dan bentuk hasil
Filter pencarian, postingan, dan komentar adalah q, subreddit, author, kind, from, to, min_score, limit, dan page. kind menerima post atau comment. Tanggal memakai YYYY-MM-DD dalam UTC; to mencakup seluruh hari. min_score adalah ambang minimum, bukan pengurutan. id hanya untuk /v1/item, bukan filter daftar postingan atau komentar. parent_id dan link_id dapat muncul pada respons tetapi bukan filter kueri. Layanan pencarian yang dihosting ini tidak berarti bahasa kueri Elasticsearch sewenang-wenang atau analisis server khusus tersedia untuk klien.
Maksimal 100 rekaman per permintaan dan 100 halaman per kueri dapat diminta; setiap halaman adalah panggilan terpisah. Hasil mengikuti urutan dokumen, bukan waktu, relevansi, atau skor. eq berarti total tepat, gte batas bawah, dan unknown atau null total tepercaya yang tidak diketahui. Total tepat tidak membuktikan penyimpanan lengkap. Pengelompokan rekaman datar bersifat pilihan untuk hubungan; membaca dan menghitung tidak memerlukan pohon dan induk yang hilang tidak dipulihkan. Pembagian tanggal dan deduplikasi tidak membuktikan kelengkapan; hitungan komunitas bukan inventaris global yang pasti.
Biaya, kesalahan, dan status
Pengambilan berhasil termasuk hasil kosong menggunakan satu kredit; 1.000 keberhasilan berharga $1. Permintaan tidak valid tidak didebit dan kegagalan sistem hulu mengembalikan cadangan. Waktu tunggu habis pada klien tidak membuktikan kegagalan server. Jika respons hilang setelah keberhasilan, percobaan ulang yang berhasil memakai kredit baru. Baca saja tidak menjamin respons identik atau pengulangan gratis. Pisahkan hasil API dari hasil penyimpanan lokal. Memproses kembali respons yang sudah ada berbeda dari mengambilnya melalui panggilan baru dan perlu dibedakan dalam anggaran produk.
400 memerlukan koreksi parameter, 401 pemeriksaan kunci, 402 pemeriksaan saldo, dan 429 pengurangan laju. Tetapkan jumlah percobaan dan kondisi berhenti; jangan melewati batas melalui akun lain. /v1/status publik tanpa biaya hanya menunjukkan cakupan statis dan respons HTTP, bukan pencarian, rekaman, kunci, atau saldo. Produk dapat membedakan hasil kosong dari kesalahan sementara, tetapi layar itu tidak memberikan jaminan layanan. Cakupan lengkap, ketetapan, penyimpanan permanen, dan kinerja tertentu tidak dijamin. Catat hasil kueri serta pemrosesan aplikasi sebagai tahap berbeda.
