Mulai dari pertanyaan untuk pelanggan
Menjelang perencanaan, seorang rekan ingin melihat cara pembuat proyek kecil membicarakan umpan balik. Fitur awalnya bisa sederhana: meminta beberapa rekaman arsip, membacanya, lalu mencatat pertanyaan yang perlu diajukan kepada pelanggan sendiri. Sedikit kecocokan pencarian bukan perkiraan permintaan atau daftar fitur yang harus segera dibangun. Gunanya adalah menyiapkan percakapan berikutnya.
Inilah tugas yang jelas untuk API Reddit yang dihosting. Pengguna berizin meminta contoh dan server aplikasi menghubungi arsip. Produk Anda menentukan siapa yang boleh membuka tampilan, menyimpan catatan, atau meminta data lagi. Kunci arsip tetap berada di server, bukan di browser pelanggan.
Pisahkan pencarian arsip dari produk Anda
Reddit API Cloud adalah arsip historis Reddit independen, bukan layanan resmi atau mitra Reddit. Tidak tersedia data langsung, OAuth, pembuatan postingan, pemungutan suara, atau pesan pribadi. Tim SaaS kecil tidak perlu menjalankan klaster Elasticsearch sendiri untuk memanggil arsip ini. Namun, ini bukan berarti seluruh infrastruktur aplikasi dikelola layanan. Sesi pengguna, hak akses produk, penanganan kesalahan, penyimpanan lokal, dan tampilan hasil tetap merupakan pekerjaan aplikasi Anda. Bedakan akses pencarian yang dihosting dari produk SaaS yang sudah dibangun dan dikelola sepenuhnya.
Mulailah dengan tindakan pengguna yang disengaja. Membuka catatan yang sudah disimpan tidak harus menjalankan pencarian berbayar lagi. Ruang riset, catatan, dan aturan penyimpanannya adalah bagian dari aplikasi Anda. Batas ini membantu tim menilai satu alur lengkap sebelum menambah jumlah pengguna atau kueri.
Uji seluruh alur dengan tiga rekaman
Permintaan awal adalah GET https://api.redditapicloud.com/v1/search?q=feedback&subreddit=SideProject&limit=3. q menentukan teks, subreddit komunitas, dan limit jumlah maksimum yang diminta. Tidak dijamin tiga rekaman atau jenis umpan balik tertentu tersedia. Panggilan kecil dapat memeriksa alur server dan penanganan hasil. Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY valid; keduanya memakai kunci arsip domain ini, bukan token OAuth Reddit. Ganti penanda dengan nilai asli pada server dan jangan meninggalkannya pada kode browser atau log. Contoh permintaan ini bukan respons nyata atau janji isi arsip.
Contoh respons kosong sintetis, hanya untuk penjelasan: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Tidak ada permintaan nyata yang dijalankan; hasil dan saldo ini adalah ilustrasi. Contoh menunjukkan bahwa respons kosong yang berhasil tetap memakai satu kredit, bukan keadaan arsip SideProject yang sebenarnya.
Periksa data serta title atau text yang tersedia sebelum menampilkan isinya sebagai teks. Rekaman bersifat datar. Jika parent_id atau link_id ada, Anda dapat mengelompokkannya secara lokal, tetapi percakapan lengkap tidak dijamin. Biarkan pembaca mengetahui bagian konteks yang tidak tersedia.
Jelaskan juga layar tanpa hasil
Hasil kosong hanya berarti panggilan tersebut tidak mengembalikan rekaman. Itu tidak membuktikan bahwa topiknya tidak pernah dibahas atau seluruh komunitas telah diteliti. Kegagalan pengambilan memerlukan keadaan layar yang berbeda. Sumber yang tidak dapat diakses bukan pencarian berhasil tanpa kecocokan.
Rekaman pertama mengikuti urutan dokumen arsip, bukan relevansi, skor, atau waktu. Pratinjau kecil menguji integrasi, bukan memilih pendapat terbaik. Pisahkan teks sumber dari kesimpulan rekan. Kelengkapan, ketersediaan terus-menerus, dan hasil identik pada kueri berikutnya tidak dijanjikan. Catatan tersimpan bukan pembaruan langsung dari Reddit.
Tentukan anggaran untuk satu tindakan
Setiap pengambilan berhasil termasuk kosong memakai satu kredit. Tarifnya $1 per 1.000 keberhasilan; minimum $50 menghasilkan 50.000 kredit berbayar. Tidak ada langganan dan kredit berbayar tidak kedaluwarsa. Uji coba 100 kredit bergantung pada kelayakan pencegahan penyalahgunaan seluruh jaringan. Akun, kunci, dan saldo khusus domain ini. Kuota pengguna produk ditetapkan pada aplikasi sendiri. Satu layar dapat memicu beberapa panggilan, sehingga jumlah rekaman atau klik pengguna bukan unit tagihan. Cookie sesi Secure HttpOnly panel juga terpisah dari header pengambilan.
Server bisa berhasil sebelum respons hilang di klien; pengulangan berhasil memakai kredit lagi. Permintaan tidak valid tidak didebit, sedangkan kegagalan sistem hulu mengembalikan cadangan. Halaman kunci menyiapkan akses, dokumentasi menjelaskan parameter, dan panduan mengembangkan pemeriksaan sebelum fitur diberikan kepada lebih banyak pengguna.
