À quelles fins les développeurs peuvent-ils utiliser l’API ?

L’API permet à votre propre code de faire ce que vous faites dans Inoreader : lister les flux, les dossiers et les étiquettes, lire les articles de n’importe quel flux, dossier, étiquette ou état, obtenir le nombre d’articles non lus, marquer les articles comme lus, leur attribuer des étiquettes ou les ajouter aux favoris, ajouter et modifier des flux, renommer ou supprimer des étiquettes et créer des flux de veille. Les utilisations typiques sont une application de lecture pour une plateforme qui n’en dispose pas, un script qui publie les articles auxquels vous attribuez des étiquettes ou un tableau de bord alimenté par vos dossiers.

Lire votre compte

Contenu du flux renvoie les articles d’un flux : un flux unique, un dossier ou une étiquette, ou un état tel que lu, ajouté aux favoris, diffusé, annoté, aimé ou pages web enregistrées. Vous choisissez le nombre d’éléments renvoyés, 20 par défaut et jusqu’à 100, l’ordre du plus ancien au plus récent ou l’inverse, une heure de début et l’exclusion ou non des articles lus, et un jeton de continuation permet de parcourir le reste par pages. Chaque article est accompagné de son identifiant, de son titre, de ses dates, de son URL, de son contenu HTML, de son auteur, de son flux d’origine et de ses catégories, ainsi que, sur demande, de vos annotations et des résumés Intelligence, au format JSON ou Atom. Identifiants des éléments renvoie uniquement les identifiants, Nombre d’articles non lus renvoie les compteurs, et Liste des flux, Liste des dossiers/étiquettes et Informations sur l’utilisateur décrivent le compte.

Modifier votre compte

Modifier une étiquette marque les articles comme lus, les ajoute aux favoris ou leur attribue des étiquettes, et Tout marquer comme lu marque comme lu l’ensemble d’un flux. Ajouter un flux et Modifier un flux permettent de s’abonner à un flux et de le modifier, Renommer une étiquette et Supprimer une étiquette permettent de gérer vos étiquettes, et Définir les préférences du flux modifie les paramètres d’un flux. Des flux de veille peuvent également être créés et supprimés, dans la limite de votre forfait.

Fonctionnement de l’accès

Les requêtes sont envoyées à https://www.inoreader.com/reader/api/0, avec GET pour lire et POST pour modifier. L’utilisateur se connecte avec OAuth 2.0 et une portée de lecture, qui ne couvre que la zone 1, ou de lecture et d’écriture. Les lectures sont décomptées de la zone 1 et les modifications de la zone 2, avec 100 requêtes par jour dans chacune pour une application Pro. Inoreader propose-t-il un accès à l’API ? explique l’enregistrement, et le portail des développeurs documente chaque méthode.

Autres possibilités

Les intégrations Zapier, IFTTT et n8n reposent sur cette API, et un flux en sortie publie un dossier ou une étiquette au format RSS ou JSON sans code. Les applications de lecture tierces reposant sur l’API sont répertoriées sous Assistance > Applications mobiles > Applications tierces.

L’accès à l’API est inclus dans les forfaits Pro et Team, tandis que les comptes gratuits n’en bénéficient que pour les applications publiques sur les plateformes où Inoreader n’en propose pas.