Rute dan autentikasi
Host pengambilan adalah https://api.redditapilabs.com. GET /v1/search untuk pencarian, /v1/posts untuk postingan, dan /v1/comments untuk komentar. /v1/item?id=... mengambil satu item yang pengenalnya diketahui; /v1/subreddits?prefix=... menyaring 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. Nyatakan batas sumber dalam protokol. Dokumentasi metode tidak memberikan jaminan ketetapan, penyimpanan permanen, atau keterwakilan sampel.
Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY valid untuk kunci arsip domain ini, bukan token OAuth Reddit. Tambahkan nilai asli pada server dan pertahankan penanda pengganti dalam contoh protokol. Cookie sesi Secure HttpOnly panel terpisah. Akun, kunci, dan saldo tidak dibagikan ke merek lain. Contoh https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3 bukan jaminan tiga hasil atau sampling acak. Catat parameter dan respons secara terpisah; jangan menaruh kunci asli pada kode publik, log, atau berkas riset. Kredensial bukan bagian yang perlu dibagikan untuk menjelaskan metode.
Filter dan bentuk data
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 skor minimum, bukan pengurutan atau pemeriksaan kualitas. id hanya untuk /v1/item dan bukan filter daftar postingan atau komentar. parent_id dan link_id dapat muncul pada respons tetapi bukan filter kueri. Catat aturan ini beserta efek seleksinya dalam protokol dan kirim nama parameter sesuai bentuk teknisnya.
Maksimal 100 rekaman per permintaan dan 100 halaman per kueri dapat diminta; setiap halaman panggilan tersendiri. Urutan dokumen bukan waktu, relevansi, atau skor. eq berarti total tepat, gte batas bawah, unknown atau null total tepercaya yang tidak diketahui. Total tepat tidak membuktikan semua hasil tersimpan. Pengelompokan rekaman datar bersifat pilihan untuk hubungan; membaca dan menghitung tidak memerlukan pohon, induk hilang tidak dipulihkan. Iterasi, pembagian tanggal, dan deduplikasi tidak membuktikan kelengkapan. Hasil awalan komunitas bukan daftar menyeluruh dan hitungan agregasinya bukan inventaris global yang pasti.
Kesalahan, biaya, dan bukti lokal
Pengambilan berhasil termasuk kosong memakai 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. Respons yang hilang setelah keberhasilan dapat diikuti pengulangan berhasil yang dikenai kredit lagi. Baca saja tidak menjamin respons identik atau percobaan gratis. Pisahkan hasil API dan hasil penulisan lokal. Memproses respons tersimpan bukan panggilan baru, sedangkan mengambil ulang adalah permintaan baru. Beri keduanya status berbeda dalam catatan pekerjaan.
400 memerlukan koreksi parameter, 401 pemeriksaan kunci, 402 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. Respons mentah, kondisi, waktu, halaman, hash berkas lokal, dan versi kode dapat disimpan dalam lingkungan sendiri. Bukti lokal ini bukan versi tetap dari API atau janji respons masa depan yang sama. Kinerja tertentu dan ketersediaan terus-menerus juga tidak dijamin.
