Зареєструйтеся та збережіть показаний ключ
Створіть обліковий запис з електронною поштою та паролем завдовжки від 12 до 72 байтів. Одразу після реєстрації, до оплати, ключ показується один раз. Скопіюйте його до сховища, придатного для секретів вашого застосунку. Вхід через Google чи підключення гаманця не потрібні, лист із ключем не надсилається. Довжина пароля з багатобайтовими символами визначається в байтах, а не лише кількістю видимих знаків.
Можливість використати пробні 100 кредитів залежить від загальномережевих обмежень проти зловживань. Якщо умови виконано, захищені запити можна перевірити без початкового платежу. Ключ і баланс належать саме redditsearchapi.com; ключ іншого домену мережі тут не працює. Дії з обліковим записом доступні в панелі на цій сторінці, тож шукати окрему адресу особистого кабінету не потрібно.
Передавайте ключ для захищених звернень
Клієнт надсилає ключ у заголовку Authorization за схемою Bearer до захищених маршрутів отримання даних. Не розміщуйте його в публічному браузерному коді, знімках екрана чи адресах прикладів. Відкритий /v1/status не потребує ключа та не витрачає кредитів. Відповідь цього маршруту описує сервіс і підтверджує відповідь HTTP-застосунку, але не показує справності пошуку або наявності потрібного запису.
Щоб замінити ключ, увійдіть до панелі та підтвердьте пароль. Повторне створення одразу робить попередній ключ недійсним, тому оновіть налаштування залежного застосунку перед подальшими зверненнями. Функції скидання пароля чи автоматичного надсилання ключа поштою не надано. Код 401 означає проблему з ключем, 402 — нестачу кредитів, 429 — обмеження частоти; кожна ситуація потребує окремої реакції вашого клієнта.
