Do czego programiści mogą używać API?

API pozwala Twojemu kodowi robić to, co robisz w Inoreaderze: wyświetlać listy kanałów, folderów i tagów, czytać artykuły z dowolnego kanału, folderu, tagu lub stanu, pobierać liczby nieprzeczytanych artykułów, oznaczać artykuły jako przeczytane, przypisywać im tagi lub oznaczać je gwiazdką, dodawać i edytować kanały, zmieniać nazwy tagów lub je usuwać oraz tworzyć monitoring kanałów. Typowe zastosowania to aplikacja do czytania na platformę, na której takiej aplikacji nie ma, skrypt publikujący artykuły, którym przypisujesz tagi, lub pulpit zasilany treściami z Twoich folderów.

Odczytuj dane swojego konta

Zawartość strumienia zwraca artykuły ze strumienia: pojedynczego kanału, folderu lub tagu albo stanu, takiego jak przeczytane, oznaczone gwiazdką, rozpowszechnione, z adnotacjami, polubione lub zapisane strony internetowe. Wybierasz liczbę zwracanych elementów, domyślnie 20, a maksymalnie 100, kolejność od najstarszych lub najnowszych, czas początkowy oraz to, czy pomijać przeczytane artykuły, a token kontynuacji umożliwia przeglądanie pozostałych stron wyników. Każdy artykuł zawiera identyfikator, tytuł, daty, adres URL, treść HTML, autora, kanał źródłowy i kategorie, a na żądanie także Twoje adnotacje i podsumowania Intelligence, w formacie JSON lub Atom. Identyfikatory elementów zwraca tylko identyfikatory, Liczby nieprzeczytanych — liczniki, a Lista kanałów, Lista folderów/tagów i Informacje o użytkowniku opisują konto.

Wprowadzaj zmiany na swoim koncie

Edytuj tag oznacza artykuły jako przeczytane, oznacza je gwiazdką lub przypisuje im tagi, a Oznacz wszystkie jako przeczytane czyści cały strumień. Dodaj kanał i Edytuj kanał umożliwiają subskrybowanie kanału i wprowadzanie w nim zmian, Zmień nazwę tagu i Usuń tag zarządzają Twoimi tagami, a Ustaw preferencje strumienia zmienia ustawienia strumienia. Monitoring kanałów również można tworzyć i usuwać, w ramach limitu Twojego planu.

Jak działa dostęp

Żądania są wysyłane na adres https://www.inoreader.com/reader/api/0, przy użyciu GET do odczytu i POST do wprowadzania zmian. Użytkownik loguje się za pomocą OAuth 2.0 z zakresem read, który obejmuje tylko Strefę 1, lub read write. Odczyt jest wliczany do limitu Strefy 1, a zmiany do limitu Strefy 2, przy czym aplikacja Pro ma limit 100 żądań dziennie w każdej z nich. Artykuł Czy Inoreader zapewnia dostęp do API? wyjaśnia rejestrację, a portal dla programistów dokumentuje każdą metodę.

Alternatywy

Integracje z Zapier, IFTTT i n8n są oparte na tym API, a kanał wyjściowy publikuje folder lub tag w formacie RSS lub JSON bez pisania kodu. Aplikacje do czytania innych firm oparte na API są wymienione w sekcji Pomoc techniczna > Aplikacje mobilne > Aplikacje innych firm.

Dostęp do API jest zawarty w planach Pro i Team, natomiast konta Free otrzymują go tylko dla publicznych aplikacji na platformach, na których Inoreader nie ma własnej aplikacji.