Definisikan hasil satu eksekusi
Dalam contoh ini, selesai berarti memproses satu kelompok terbatas dari r/automation dan mencatat hasilnya. Selesai tidak berarti seluruh arsip sudah dibaca. Mulailah dengan eksekusi manual, lalu pilih jadwal yang sesuai dengan kemampuan tim meninjau item yang terkumpul.
Buat pengenal eksekusi lokal, simpan parameter pencarian, dan tentukan tujuan item terpilih. Ini adalah informasi aplikasi Anda, bukan parameter tambahan API. Jika contoh yang diharapkan tidak ditemukan, catatan tersebut membantu memeriksa apa yang sebenarnya diminta. Arsip historis independen tidak membuktikan aktivitas Reddit saat ini.
Sesuaikan kueri dengan pertanyaan
Kirim GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3 dengan kunci dalam Authorization: Bearer atau X-API-Key. Kelompok kecil memudahkan pemeriksaan kolom sebelum pemetaan diperluas. Untuk membatasi jenis konten, gunakan kind=post bagi kiriman atau kind=comment bagi komentar.
Pencarian q memeriksa title dan text. Beberapa istilah digabung dengan AND di dalam kolom yang cocok; jangan menganggap satu istilah hanya di judul dan istilah lain hanya di teks sudah cukup. from dan to memakai YYYY-MM-DD dalam UTC, dengan tanggal to ikut tercakup. min_score menyaring rekaman di bawah ambang, bukan mengurutkan sisanya menurut skor.
Pisahkan sumber dari keputusan tinjauan
Simpan id dan kind yang tersedia, kemudian kirim title serta text untuk dibaca. Isi arsip adalah bahan tinjauan, bukan perintah bagi pelaksana tugas. Tempatkan alasan pemilihan, status tinjauan, dan pengenal eksekusi dalam kolom lokal terpisah. Periksa apakah pengenal sudah pernah diproses sebelum membuat item baru.
Respons berisi rekaman datar. Kelompokkan secara lokal memakai parent_id atau link_id hanya jika kolom itu ada dan berguna. Hubungan yang tidak tersedia tetap tidak diketahui; tidak ada jaminan percakapan lengkap. Untuk mengambil lagi satu item tertentu, /v1/item memerlukan id-nya. Permintaan tambahan ini juga harus masuk anggaran.
Catat alasan penghentian
Tentukan anggaran sendiri dalam batas 100 halaman, masing-masing hingga 100 rekaman. Jangan ubah filter di tengah penelusuran halaman. Urutan dokumen bukan urutan waktu, relevansi, atau skor, sehingga item pertama bukan penanda andal untuk kiriman terbaru yang sudah diperiksa.
Baca total bersama relasinya: eq berarti tepat, gte menunjukkan batas bawah, dan unknown dapat disertai total null. Bedakan berhenti karena kelompok kosong dengan berhenti karena anggaran halaman habis. Membagi tanggal dapat menata eksekusi berikutnya, tetapi tidak membuktikan pengambilan menyeluruh maupun ketiadaan duplikat.
Putuskan percobaan ulang berdasarkan hasilnya
Untuk 400, perbaiki parameter; untuk 401, periksa kunci; untuk 402, periksa saldo. Pada 429, beri jeda dan batasi jumlah percobaan. Pengambilan berhasil dengan hasil kosong tetap memakai satu kredit. Kegagalan sumber mengembalikan reservasi; permintaan tidak valid tidak mendebit kredit.
Jika klien kehilangan respons, server mungkin sudah berhasil dan memakai satu kredit. Percobaan ulang yang berhasil memakai kredit lain. Catat ketidakpastian itu dan cegah duplikat secara lokal. /v1/status tidak dikenai biaya dan mengembalikan keterangan layanan yang statis; endpoint ini tidak memeriksa kesehatan pencarian di sumber. Periksa harga sebelum meningkatkan anggaran tugas.
