Mire használhatják a fejlesztők az API-t?

Az API lehetővé teszi, hogy a saját kódod elvégezze azt, amit az Inoreaderben teszel: hírfolyamokat, mappákat és címkéket listázzon, bármely hírfolyam, mappa, címke vagy állapot cikkeit olvassa, lekérje az olvasatlan cikkek számát, olvasottként jelölje, címkézze vagy csillagozza a cikkeket, hírfolyamokat adjon hozzá és szerkesszen, címkéket nevezzen át vagy töröljön, valamint figyelő hírfolyamokat hozzon létre. Tipikus felhasználási mód egy olvasóalkalmazás olyan platformra, amelyen még nincs ilyen, egy szkript, amely közzéteszi az általad megcímkézett cikkeket, vagy egy irányítópult, amely a mappáidból kapja az adatokat.

Fiókod olvasása

Az Adatfolyam tartalma egy adatfolyam cikkeit adja vissza: egyetlen hírfolyamét, egy mappáét vagy címkéét, illetve egy állapothoz tartozókat, például az olvasott, csillagozott, közzétett, megjegyzéssel ellátott vagy kedvelt cikkeket, illetve a mentett weboldalakat. Kiválaszthatod a visszaadott elemek számát, amely alapértelmezés szerint 20, legfeljebb pedig 100, hogy a legrégebbiek vagy a legújabbak legyenek elöl, a kezdő időpontot, és azt, hogy kimaradjanak-e az olvasott cikkek, a folytatási token pedig lehetővé teszi a többi elem lapozását. Minden cikkhez megkapod az azonosítóját, címét, dátumait, URL-jét, HTML-tartalmát, szerzőjét, forráshírfolyamát és kategóriáit, kérésre pedig a megjegyzéseidet és az Intelligence-összefoglalókat is, JSON vagy Atom formátumban. Az Elemazonosítók csak az azonosítókat adja vissza, az Olvasatlan elemek száma a számlálókat, a Hírfolyamlista, a Mappa-/címkelista és a Felhasználói adatok pedig a fiókot írják le.

Fiókod módosítása

A Címke szerkesztése olvasottként jelöli vagy csillagozza a cikkeket, illetve címkéket rendel hozzájuk, az Összes megjelölése olvasottként pedig egy teljes adatfolyamot olvasottként jelöl. A Hírfolyam hozzáadása és a Hírfolyam szerkesztése feliratkozik egy hírfolyamra, illetve módosítja azt, a Címke átnevezése és a Címke törlése a címkéidet kezeli, az Adatfolyam beállításainak megadása pedig módosítja egy adatfolyam beállításait. Figyelő hírfolyamok is létrehozhatók és törölhetők, a csomagod korlátain belül.

Hogyan működik a hozzáférés?

A kérések a https://www.inoreader.com/reader/api/0 címre érkeznek, olvasáshoz GET, módosításhoz POST használatával. A felhasználó OAuth 2.0-val és read hatókörrel jelentkezik be, amely csak az 1. zónára terjed ki, vagy read write hatókörrel. Az olvasás az 1. zóna, a módosítások pedig a 2. zóna keretébe számítanak bele, Pro-alkalmazás esetén mindkettőben napi 100 kéréssel. A Biztosít az Inoreader API-hozzáférést? a regisztrációt ismerteti, a fejlesztői portál pedig minden metódust dokumentál.

Alternatívák

A Zapier-, IFTTT- és n8n-integrációk erre az API-ra épülnek, egy kimeneti hírfolyam pedig kód nélkül tesz közzé egy mappát vagy címkét RSS vagy JSON formátumban. Az API-ra épülő, harmadik féltől származó olvasóalkalmazások a Támogatás > Mobilalkalmazások > Harmadik féltől származó alkalmazások alatt találhatók.

Az API-hozzáférés a Pro és Team csomagok része, míg az ingyenes fiókok csak olyan platformokon elérhető nyilvános alkalmazásokhoz kapják meg, amelyeken az Inoreadernek nincs saját alkalmazása.