Отримання токена доступу: Пригода починається! Щоб отримати свій токен доступу, вам доведеться пройти захопливий процес авторизації. Перш ніж вирушити в цю пригоду, просто зайдіть на сайт і перемістіть курсор до особистого кабінету.

На вкладці "Ключі доступу" натискайте на кнопку «Створити новий ключ». Зверніть увагу: поки що він неактивний, як ваші плани на вечір, коли настає час зустрічі з друзями! Щоб активувати ключ, натисніть «Активувати» (так, це справжня магія!) і заповніть форму, детально описуючи, для чого ж вам цей токен. Напишіть так, щоб ваша заявка виглядала як захопливі плани на поїздку в Париж, а не нудний похід у магазин. Після цього надішліть заявку і чекайте з нетерпінням! Пам’ятайте: хороші речі завжди приходять до тих, хто терпить!

Доступ до API: Ваш пропуск у світ можливостей Для того, щоб зануритися у світ API, вам знадобиться ваш особистий API токен — без нього, як без ключа від власного авто: ніяк не заїдеш у гараж! Щоб отримати список актуальної тривоги, просто виконайте GET запит на https://i-horizon.site/api/v1/alarm/active/, а в заголовку (Header) в рядку Token передайте ваш токен (пам’ятайте: без "TOKEN" ніякої магії не відбудеться).

Усі методи API можуть повертати помилки, які вразять ваші надії: 200 - Запит виконано успішно (так, час святкувати! ) 401 - Невірний токен або він не активний (на жаль, не всі герої носять плащі). 429 - Перевищений ліміт запитів (так, ви розчаровані, але зате у вас новий рекорд). 400 - Інші можливі помилки (такі собі «фейли» на фоні грандіозного шоу).

Не забувайте: на всі API запити діють обмеження — максимум 1 запит кожні 15-20 секунд. Так, ми не влаштовуємо перегони, але для вас це може бути на краще. Якщо ж ви все ж систематично будете порушувати ліміти, ваш токен буде заблоковано, і доведеться шукати нового друга для спілкування. Тож готуйтесь, отримуйте свій токен, і вперед — до нових звершень!

Щоб дізнатися, які категорії новин доступні, ви можете використовувати ендпоінт https://i-horizon.site/api/v1/news/region/. Цей запит відкриє перед вами двері у світ новин, де ви зможете знайти інформацію про різноманітні теми, від регіональних новин до автомобільних технологій. Успішний запит поверне список категорій, кожна з яких буде містити id, name, та description. Не соромтеся досліджувати новини Волині чи автомобільні інновації — можливості безмежні! У випадку помилок, API не залишить вас на самоті: 200 - Запит виконано успішно (підготуйтеся до читання!) 404 - Неправильний запит (на жаль, ви потрапили в глухий кут).

Отримання новин за категорією Після того, як ви ознайомилися з категоріями новин, ви можете отримати список новин за конкретною категорією, використовуючи ендпоінт https://i-horizon.site/api/v1/news/region/id/. Замість id ви повинні вставити ідентифікатор категорії, який вас цікавить. За замовчуванням ви отримаєте 10 новин, але якщо ви хочете більше (але не більше 50), просто передайте параметр count. Наприклад: https://i-horizon.site/api/v1/news/region/1/?count=20 поверне 20 новин з категорії з id 1. Успішний запит поверне не тільки новини, а й дату створення, заголовок, та картинку для кожної новини. А якщо вам цікаво, звідки взялися ці новини, не біда — ми вам про це розкажемо!

Отримання джерел новини Коли ви натрапите на захоплюючу новину, не забудьте дізнатися, з яких джерел вона була опублікована. Для цього використовуйте ендпоінт https://i-horizon.site/api/v1/news/source/news_id/, де news_id — це ідентифікатор новини, який ви отримали раніше. Цей запит поверне вам перелік всіх джерел, де новина була опублікована, з назвами сайтів та прямими посиланнями.

Якщо ти успішно приручив свою персональну стрічку новин з Telegram, можеш запитати її за допомогою GET-запиту. Вдаривши по ендпоінту https://i-horizon.site/api/v1/news/content_telegram/, отримаєш доступ до налаштованих тобою новинних стрічок. Але є нюанс: не забудь додати свій токен у Headers, бо без нього сервер просто скаже: «Не сьогодні, друже». Тож, тримай токен на готові, і вперед за новинами!

Якщо хочеш конкретно поритись в новинах, просто бахни GET-запит на https://i-horizon.site/api/v1/news/content_telegram/id/ і заміни "id" на той самий ID стрічки, який ти добув у попередньому запиті. У відповідь тобі автоматично прилетить 10 найсвіжіших новин, але якщо цього замало — не проблема! Передай параметр "count" із бажаною кількістю новин. Наприклад, запит на https://i-horizon.site/api/v1/news/content_telegram/1/?count=20 видасть тобі 20 топових новин з цієї стрічки з ID 1. Ну, все просто — новини на замовлення!

Якщо хочеш, щоб дані самі тебе знаходили, а не ти їх — вебхук тобі в поміч! Це такий крутий хлопець, який, щойно щось відбувається, одразу стукає до тебе в дім (точніше, на твій URL) і приносить всі новини, тривоги й контент на тарілочці. Все це добро можна налаштувати в твоєму персональному кабінеті в розділі "WEBHOOK".

СТАН ПОВІТРЯНОЇ ТРИВОГИ Якщо хочеш знати, коли почалась або закінчилась повітряна тривога, то обери потрібний регіон (чи кілька) і вкажи свій URL-адресу у форматі "https://". Як тільки щось станеться — БАМ! Сповіщення прилетить.

СПОВІЩЕННЯ НОВИН Хочеш новини на автоматі? Легко! Обирай регіон чи категорію (а можна і все відразу) і вказуй свій URL. Далі тільки сиди й приймай найсвіжіші апдейти без зайвих зусиль.

ПЕРСОНАЛЬНА СТРІЧКА TELEGRAM Якщо вже налаштував собі персональну стрічку новин, як справжній профі (дивись трохи нижче, як це зробити), то тепер можеш отримувати всі новини з обраних Telegram-каналів прямо на свій URL. Знову ж таки, обирай стрічку, введи URL і натискай "створити вебхук".

І вітаю! Тепер ти як "людина-радар" — завжди в курсі всього важливого і не пропустиш нічого, бо все прилетить автоматично!

Тепер у тебе є можливість підключити ЮЗЕР-БОТА — це такий телеграм-аккаунт, який готовий допомогти вирішити купу твоїх питань! Зокрема, з його допомогою ти можеш створити свою власну, унікальну стрічку новин.

Що потрібно зробити? Все просто: Заходь у свій особистий кабінет та перейдіть у налаштування юзер-ботів. На вкладці ДОДАТИ АКАУНТ TELEGRAM введи номер телефона, на якому є активний телеграм-акаунт. Чекай код підтвердження, який телеграм скине прямо в месенджер (вони такі люб’язні). Введи цей код у вікно, а якщо у тебе ще й двофакторка, доведеться підкинути ще й її код. Але не переживай, це для твоєї ж безпеки!

От і все — ти додав агента! 🎉 Протягом 3-10 хвилин він може бути трохи лінивим і неактивним, але не хвилюйся, він просто синхронізується з сервером і збирає всі свої дані. Після цього ти отримаєш повний список доступних чатів і каналів для цього акаунта. А далі — справжня магія! Ти зможеш автоматизувати процес отримання контенту з телеграм-каналів і чатів. Справжній агент під прикриттям, який зробить всю роботу за тебе! 😎

У вкладці Контент в твоєму особистому кабінеті ти зможеш створити свою унікальну стрічку новин, обравши лише той контент, який тобі до вподоби. Це як налаштувати свій ідеальний канал!

Спочатку придумай креативну назву для своєї стрічки та введи її. І пам'ятай, стрічок можна створити скільки завгодно! Коли ти створиш свою стрічку, трохи нижче з’являться її налаштування. Тобі потрібно буде вибрати агента (юзер бота), натиснути «Далі», і вже тут можна обирати канали, з яких ти бажаєш отримувати контент. Просто клацни на потрібні канали і додай їх до своєї стрічки.

У налаштуваннях стрічки буде вказано її статус: якщо вона активна, то вітаю! 🎊 Ти успішно отримуєш контент з обраних каналів. І так, ти можеш змінювати, додавати або навіть видаляти канали в обраній стрічці.

Увесь отриманий контент буде відображатися тільки для тебе, якщо ти, звісно, авторизований на сайті у вкладці Персональна стрічка. А якщо ти розробник, то можеш отримувати цей контент через API або через webhook для створення власних шедеврів (як це зробити, вже описано раніше).