Для чого розробники можуть використовувати API?

API дає змогу вашому власному коду робити те, що ви робите в Inoreader: отримувати списки стрічок, папок і тегів, читати статті будь-якої стрічки, папки, тегу або стану, отримувати кількість непрочитаних статей, позначати статті як прочитані, додавати до них теги чи зірочки, додавати й редагувати стрічки, перейменовувати або видаляти теги та створювати моніторингові стрічки. Типові приклади використання — застосунок для читання на платформі, де такого немає, скрипт, який публікує статті, позначені вами тегами, або інформаційна панель, що отримує дані з ваших папок.

Читання даних вашого облікового запису

Вміст потоку повертає статті потоку: окремої стрічки, папки чи тегу або стану, як-от прочитані, із зірочкою, трансльовані, з анотаціями, вподобані чи збережені вебсторінки. Ви вибираєте, скільки елементів повертати — 20 за замовчуванням і до 100, — які показувати першими: найстаріші чи найновіші, час початку та чи виключати прочитані статті, а токен продовження дає змогу посторінково переглядати решту. Кожна стаття надається з її ідентифікатором, заголовком, датами, URL-адресою, HTML-вмістом, автором, вихідною стрічкою та категоріями, а за запитом — із вашими анотаціями та стислими викладами Intelligence, у форматі JSON або Atom. Ідентифікатори елементів повертають лише ідентифікатори, Кількість непрочитаних — лічильники, а Список стрічок, Список папок/тегів та Інформація про користувача описують обліковий запис.

Змінення вашого облікового запису

Редагування тегу позначає статті як прочитані, додає до них зірочки або призначає теги, а Позначення всіх як прочитаних очищає весь потік. Додавання стрічки та Редагування стрічки дають змогу підписатися на стрічку й змінити її, Перейменування тегу та Видалення тегу керують вашими тегами, а Встановлення налаштувань потоку змінює налаштування потоку. Моніторингові стрічки також можна створювати й видаляти в межах ліміту вашого тарифного плану.

Як працює доступ

Запити надсилаються на https://www.inoreader.com/reader/api/0: GET — для читання, POST — для внесення змін. Користувач входить за допомогою OAuth 2.0 з областю доступу read, яка охоплює лише зону 1, або read write. Читання зараховується до ліміту зони 1, а зміни — до ліміту зони 2, по 100 запитів на день у кожній для застосунку Pro. У статті Чи надає Inoreader доступ до API? пояснюється реєстрація, а на порталі для розробників задокументовано кожен метод.

Альтернативи

Інтеграції із Zapier, IFTTT та n8n побудовані на цьому API, а вихідна стрічка публікує папку або тег у форматі RSS чи JSON без написання коду. Сторонні застосунки для читання, побудовані на API, наведені в розділі Підтримка > Мобільні застосунки > Сторонні застосунки.

Доступ до API включено до тарифних планів Pro і Team, тоді як облікові записи Free отримують його лише для загальнодоступних застосунків на платформах, де Inoreader не має власного застосунку.