Дайте знайденим прикладам практичне призначення
Припустімо, команда щотижня обговорює, які ручні операції варто автоматизувати. Для такої зустрічі корисно мати добірку давніших дописів про робочі процеси з r/automation. Ваше заплановане завдання може отримати невелику порцію записів і додати обрані приклади до черги на опрацювання. Людина перегляне їх і вирішить, що заслуговує на окрему перевірку.
API Reddit CC надає доступ до незалежного історичного архіву, а розклад, чергу й правила добору створюєте ви. Сервіс не пов’язаний із Reddit і не передає події наживо. Повторення запиту наступного тижня не гарантує нових дописів. Цей підхід доречний для пошуку вже описаних ідей, коли вам важливий приклад процесу, а не негайне сповіщення.
Почніть із запиту, який легко перевірити
Приклад на головній сторінці: GET https://api.apireddit.cc/v1/search?q=workflow&subreddit=automation&limit=3. Значення q задає слово workflow, subreddit обмежує спільноту, limit дозволяє повернути щонайбільше три записи. Такий невеликий обсяг зручно оглянути перед налаштуванням обробника. Результат може містити менше записів або бути порожнім навіть за успішного виконання.
Перевірте, у якому контексті автор уживає слово workflow. Чи описано послідовність дій, яку варто обговорити, чи збіг лише випадковий? Висновок про користь прикладу належить вашій команді. Сам пошук не оцінює технічну придатність рішення. Додавайте власну коротку примітку про добір, щоб наступний читач розумів, чому саме цей запис опинився у черзі.
Збережіть у журналі також причину пропуску: невідповідний зміст, уже відома знахідка або брак контексту. Так під час наступної зустрічі можна пояснити відбір, не запускаючи пошук повторно лише заради перевірки власного рішення.
Відокремте запис джерела від робочої позначки
Відповіді містять плоскі записи. Доступні id, kind, title та text можна перенести до власної картки, а номер запуску і стан опрацювання зберігати окремо. Розрізняйте допис і коментар. Якщо якогось поля немає, позначте відсутність; заповнювати прогалину вигаданим заголовком не потрібно, бо це ускладнить перевірку джерела.
За наявності parent_id або link_id дозволене локальне групування. Воно може показати зв’язок між отриманими записами, проте не забезпечує повної розмови. Перш ніж створити нову картку, перевіряйте локально, чи цей запис уже опрацьовували. Це правило вашої черги, а не обіцянка, що архів ніколи не поверне повторів або зберігатиме незмінну видачу.
Визначте межі перед увімкненням розкладу
Один запит повертає до 100 записів, одна пошукова вибірка обмежена 100 сторінками. Порядок документів архіву не є хронологічним і не відображає релевантність чи оцінку. Вирішіть заздалегідь, скільки сторінок опрацьовувати за запуск і коли зупинятися. Більший ліміт не доводить, що ви зібрали всі відповідні матеріали.
Успішний запит, навіть із порожньою відповіддю, витрачає один кредит. Тариф — $1 за 1000 запитів; мінімальне поповнення $50 дає 50000 оплачених кредитів без строку дії. Умови доступу та пробних кредитів наведено на сторінці ключа. Посібник пояснює журнал запусків і повтори, документація — параметри пошуку.
