Почніть із меж роботи для користувача
Функція добору матеріалів про онбординг потребує рішення ще до першого пошуку: скільки роботи з архівом може замовити один користувач? Reddit API Gateway надає інженерам продуктової інфраструктури доступ до незалежного історичного архіву Reddit. Це не офіційний сервіс і не джерело оновлень наживо. Приклад із SaaS допоможе визначити межі такої функції.
Уявіть екран, на якому користувач просить кілька історичних згадок про онбординг. Сервер перевіряє його право на цю дію й приймає обмежене завдання. Правила доступу та ліміти клієнтів належать вашому застосунку. Ключ визначає обліковий запис, з якого оплачуються звернення; він не розподіляє ролі й залишок кредитів між користувачами продукту.
Перевірте запит на три записи
Спробуйте GET https://api.redditapigateway.com/v1/search?q=onboarding&subreddit=SaaS&limit=3. q=onboarding задає текстовий пошук, subreddit=SaaS обмежує спільноту, limit=3 запитує щонайбільше три записи. Можливі дописи й коментарі; наявність матеріалів і корисних продуктових порад не гарантована. На сервері передавайте X-API-Key: <ключ> або Authorization: Bearer <ключ>; обидва варіанти використовують ключ саме цього архіву.
Синтетичний фрагмент відповіді, лише для демонстрації: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Це не справжній результат, баланс вигаданий. Успішна порожня вибірка також коштує один кредит. Перевірте data та збережіть отриману відповідь до перетворення. Не підміняйте лічильника запитів архіву власним лічильником записів, які пройшли перевірку й потрапили до інтерфейсу продукту.
Рахуйте спроби, а не збережені рядки
Для планування дозвольте завданню щонайбільше три спроби отримання. Три успішні запити коштуватимуть три кредити, або $0.003, навіть якщо жоден запис не підійшов для показу. Така межа є вашим правилом, а не готовою квотою архіву. Враховуйте переходи між сторінками й повторні спроби разом із початковим зверненням.
Розрізняйте повторне опрацювання та нове отримання. Збережену відповідь можна опрацювати локально без нового запиту до архіву. Оновлення може повернути інші дані й у разі успіху витратить ще один кредит. Якщо кнопка оновлення запускає платну роботу, дайте користувачеві змогу свідомо обрати цю дію.
Вирішіть, що саме показати читачеві
Відповіді вмісту містять плоскі записи зі змінним складом полів. Наявні parent_id та link_id можуть підтримувати локальне групування без повної розмови. _doc — внутрішній порядок документів, не хронологія, релевантність чи оцінка; min_score фільтрує без сортування. Запит вмісту повертає до 100 записів, page приймає від 1 до 100 в окремих зверненнях. Обхід, поділ дат і усунення дублікатів не доводять повноти чи унікальності.
Називайте результат отриманою вибіркою. Коротка сторінка не доводить, що інших обговорень онбордингу в SaaS немає. Локальне групування також не відновлює повну розмову. Зберігайте параметри та відомості про отримання поруч із відібраними матеріалами, щоб колега розумів підстави ваших висновків.
Підготуйте вибірку до роботи в продукті
Документація допоможе вибрати фільтри, а сторінка цін — оцінити дозволений обсяг звернень. На сторінці ключа підготуйте обліковий запис і поповнення; у посібнику простежте шлях секрету через завдання та його заміну. Визначте відповідальних за ці кроки перед регулярним використанням функції.
Реєстрація за електронною поштою та паролем показує ключ один раз одразу, до оплати. Пароль займає 12–72 байти UTF-8; 100 пробних кредитів залежать від загальномережевого захисту від зловживань. Мінімальне платне поповнення $50 дає 50000 кредитів за ціною $1 за 1000 успіхів. Підписок немає, оплачені кредити не мають строку дії. До оплати вивчіть документацію, ціни, сторінку ключа й посібник. Публічний /v1/status безоплатний, але підтверджує лише HTTP-відповідь і статичний опис, а не працездатність пошуку чи баланс.
