Periksa lingkup dan keadaan penyimpanan
Reddit API Proxy adalah gerbang arsip historis independen. Ini bukan API resmi atau langsung, proxy transparan, sesi OAuth, maupun layanan melewati pemblokiran Reddit. Tindakan tulis, suara, dan pesan pribadi tidak tersedia. Mengirim permintaan baca tidak menjamin hasil tidak berubah, seluruh riwayat tersedia, atau pengulangan gratis. Evaluasi keputusan mencoba kembali bersama batas data dan penggunaan kredit, bukan hanya berdasarkan nama operasi.
Periksa konfigurasi parameter dan kunci di server sebelum mengirim. Authorization: Bearer YOUR_API_KEY atau X-API-Key: YOUR_API_KEY dapat digunakan. Nilainya kunci arsip domain ini, bukan token OAuth Reddit lama. Lacak pekerjaan, kueri, dan halaman tanpa mencetak header rahasia. Cookie panel akun tidak menggantikan header pengambilan. Satu contoh yang bekerja bukan bukti bahwa seluruh konfigurasi klien sudah sesuai atau semua rute mempunyai bentuk respons sama.
Gunakan https://api.redditapiproxy.com/v1/comments?subreddit=devops&limit=3 sebagai awal kecil. subreddit memilih komunitas dan limit maksimum catatan dalam satu respons. Periksa HTTP lalu bidang yang benar-benar ada. Bila respons sudah disimpan, tentukan alasan harus mengambil ulang. Misalnya, kesalahan tampilan tidak selalu mengharuskan halaman diambil lagi dari arsip; keputusan mengikuti kebutuhan penyimpanan dan kebaruan aplikasi Anda sendiri.
Berikan tindakan berbeda untuk setiap HTTP
HTTP 400 berkaitan dengan bentuk atau nilai parameter. Tanggal memakai UTC YYYY-MM-DD dan hari to termasuk. Pada pencarian serta daftar posting atau komentar, limit dan page menerima 1–100. Hapus filter parent_id atau link_id yang tidak didukung; id hanya digunakan pada /v1/item?id=.... Mengirim ulang kondisi salah tanpa perubahan tidak memperbaiki penyebab. Periksa masukan sebelum menerapkan jeda atau menambah percobaan.
HTTP 401 menunjukkan kunci hilang atau tidak valid. Periksa nama header, kunci milik domain yang benar, dan apakah konfigurasi diperbarui setelah regenerasi. Pengguna yang sudah masuk dapat meregenerasi dengan kata sandi; kunci lama langsung tidak berlaku. Panel tidak menampilkan ulang nilai lama atau mengirimkannya melalui email. Jangan mengganti kunci secara sembarang hanya untuk melihat perubahan kesalahan; periksa dahulu bagaimana kredensial dibaca dan dikirim aplikasi.
HTTP 402 berarti saldo kurang dan HTTP 429 berarti batas laju. Untuk 402 periksa saldo aktual; bila perlu isi saldo dengan membuat tagihan setelah login dan meminta verifikasi transfer pada token serta jaringan yang benar. Untuk 429 tunda pengiriman baru; jeda yang meningkat dapat dipertimbangkan dalam aplikasi. Tidak ada jaminan berhasil setelah waktu tertentu atau akses tanpa gangguan. Jangan memakai pergantian akun untuk menghindari pembatasan.
Pisahkan koneksi ambigu dari keberhasilan berbayar
Setiap pengambilan berhasil, termasuk kosong, memakai satu kredit. Permintaan tidak valid tidak mendebit; kegagalan sumber hulu mengembalikan cadangan. Server dapat menyelesaikan permintaan berbayar sebelum respons hilang pada klien, dan pengulangan berhasil berbiaya lagi. Karena itu semua masalah koneksi tidak boleh dianggap gratis. Tetapkan batas percobaan serta ukuran pekerjaan sesuai kebutuhan dan hindari pengulangan cepat tanpa akhir yang tidak memeriksa hasil sebelumnya.
Pencarian, posting, dan komentar dibatasi 100 catatan per permintaan serta 100 halaman per kueri, dengan setiap halaman diminta terpisah. Urutan dokumen arsip bukan waktu, relevansi, atau skor. min_score adalah ambang skor, bukan pengurutan. Relasi eq berarti tepat, gte batas bawah, dan unknown atau null tidak ada total andal. Angka tepat tidak membuktikan seluruh catatan tersimpan; paginasi serta pembagian tanggal tidak menjamin hasil lengkap atau unik.
Catatan datar dapat dibaca atau dihitung tanpa pohon. Pengelompokan bidang hubungan bersifat opsional dan tidak memulihkan konteks hilang. /v1/status tidak berbiaya, menunjukkan cakupan tetap dan respons HTTP, bukan memeriksa arsip, kunci, atau saldo. Beranda memuat uji header, Dokumentasi kontrak, Harga anggaran, dan Dapatkan kunci API operasi akun. Pertahankan penjelasan hasil sesuai dengan catatan yang benar-benar diterima dan disimpan oleh aplikasi.
