C@fé Renatis mardi 26 mai - API REST 1e partie
visio
Cet atelier « API : requêtage et collecte » met l’accent sur des outils, normes, pratiques et usages au plus près de nos besoins et aspects métier (IST).
Il n’y a pas de prérequis particulier (pas de programmation à proprement parler, plutôt des approches documentaires et web).
Il permet d'apprendre comment écrire les requêtes API REST avec une approche générique, en prenant en compte des pratiques issues du web, ainsi que de la manière pour lancer ces requêtes (navigateur, outil dédié,...), de pour récupérer les réponses retournées par les API interrogées et dans quels formats.
La formation sera proposée en 2 parties d'1h30 chacune (mardi 26 mai et mardi 2 juin).
Des détails techniques complémentaires sont précisés ci-après. Ils seront rappelées aux inscrits.
Seront abordés les aspects suivants :
- Découverte d'outils sous Windows, en particulier Insomnia, pour utiliser des API même sans formulaire web pour interroger un réservoir de données accessible par API
- Découverte pratique de quelques API REST (qui sont les plus nombreuses liées à nos activités)
- Et divers aspects techniques et web : routes et paramètres API, protocoles GET/POST, identification par token,...
Modalités pratiques
Si vous souhaitez réaliser les exercices tels qu'ils seront présentés lors de la session, il faut procéder préalablement aux opérations suivantes (une identification avec votre email est à paramétrer).
- Outil Insomnia (outil pour un usage gratuit) [https://insomnia.rest/]
Créer un compte avec email, se loguer et installer une version gratuite pour Windows (Get Started for Free). C’est l’outil qui sera utilisé pour travailler avec les API.
Pour installer Insomnia, certains trouvent plus facile de passer par cet autre lien (également officiel).
- 2 bases seront interrogées
- Meteo Concept (API, en mode gratuit pour l’atelier). Utiliser le menu « S’inscrire » (en haut de la page), puis créer un compte avec votre email.
- OpenAlex (API, en mode gratuit pour votre clé API). Utiliser l’icône en bas à gauche, puis créer un compte avec votre email (si pas déjà fait).
- Outil Notepad++ [https://notepad-plus-plus.org/downloads/] (si vous n’en disposez pas déjà. C’est un éditeur de texte léger orienté code, bien pratique pour certaines manipulations. Il est gratuit et possède une interface en Français.
Formateur : Philippe Houdry CNRS - Inist
Ingénieur à l’Inist-CNRS depuis 1991. Chargé d’ingénierie documentaire, il manipule des données sous différents formats notamment XML et JSON surtout avec Python et divers outils comme OpenRefine ou LODEX, associés à l’usage d’API et de web services. Il est aussi formateur sur beaucoup de ces sujets, tant à l’Inist qu’en tant que formateur interne du CNRS et auprès de l’Université de Lorraine.