Comment les API peuvent vous faire économiser du temps ?

Dans un monde où chaque seconde compte, apprendre à utiliser les API peut transformer votre quotidien. Dans cet article, nous allons explorer comment ces interfaces permettent de simplifier la communication entre différents programmes, vous aidant ainsi à gagner un temps précieux. Que vous souhaitiez télécharger des images de chats ou automatiser le suivi des taux de change, vous découvrirez des exemples concrets et des scripts simples pour intégrer les API dans vos projets. Préparez-vous à rendre vos tâches quotidiennes plus efficaces et moins fastidieuses grâce à ces outils puissants !

1 Introduction

Commençons par une définition. Une API (Application Programming Interface) est une interface qui permet à plusieurs programmes de communiquer entre eux. En général, des messages sont échangés entre clients (ordinateurs, téléphones, consoles…) et serveurs en formats JSON ou XML. Voici une petite représentation graphique de comment ça marche :

graph LR;
    A["Client (ordinateur, téléphone)"] -->|requête| B(serveur)
    B -->|réponse| A

2 Un Exemple

Passons à un exemple réel. Disons que pendant votre pause, vous voulez regarder des photos de chats (pourquoi pas ?). Il peut y avoir deux méthodes pour effectuer cette tâche.

Ouvrir manuellement votre navigateur web/twitter/instagram et rechercher les dites photos (👎).
Utiliser une API comme un boss.

Voici un petit script Python qui peut faire l’affaire.

python

# librairie qui permet de faire des requêtes
import requests 
 
# lien de l'API
URL = "https://cataas.com/cat"

# le code ci-dessous envoie une requête "GET" au serveur
response = requests.get(url = URL)

# on vérifie que la requête a réussi et ensuite on télécharge l'image
if response.status_code == 200:
    with open('chat.png', 'wb') as f:
        f.write(response.content)
    print('Image Téléchargée !')
else:
    print("L'image n'a pas pu être téléchargée...")

Voici l’image obtenue après avoir exécuté le programme :3

OK, il faut avouer que ce n’est pas aussi facile que ça. Il faut écrire le code, l’exécuter, et enfin visionner l’image.

3 Un Autre Exemple

Prenons un autre exemple (cette fois-ci un vrai) pour montrer comment une API peut être réellement utile, et plus important, vous faire gagner du temps.

Voici un fichier Google Sheet où l’on veut convertir un montant d’une monnaie à une autre.

Encore une fois, il y a deux méthodes pour faire cette tâche.

La première consiste à chercher manuellement le taux de change sur Internet, et ensuite l’insérer dans le document. Il faudrait noter que les taux de change changent constamment. Cela implique qu’il faudra de temps en temps vérifier si le taux de change a changé, et ensuite le modifier si nécessaire. Pas du tout pratique.

La deuxième méthode est plus simple : utiliser une API. Heureusement, le site FreeCurrencyAPI propose une API qui permet de facilement avoir le taux de change de plusieurs monnaies. Pour faire cela, nous allons écrire un script en utilisant Google App Script. Nous pouvons faire cela en cliquant sur le bouton Extensions, puis App Script sur le Google Sheet. Ensuite, voici le code qui va simplifier notre vie :

appscript

function getExchangeRate() {
  // initialisation du spreadSheet
  const spreadSheet = SpreadsheetApp.getActiveSpreadsheet()

  // nous allons travailler sur la sheet "Taux de Changes"
  const sheet = spreadSheet.getSheetByName("Taux de Changes")

  // baseCurrency correspond à la case monnaie de base sur la sheet
  const baseCurrency = sheet.getRange("B2").getValue()

  // targetCurrency correspond à la case monnaie visée sur la sheet
  const targetCurrency = sheet.getRange("B3").getValue()

  // remplacer cette valeur par votre clé API obtenue sur FreeCurrencyAPI
  const apikey = "<VOTRE CLÉ API>"

  // url de l'API, avec cette adresse nous pourrons communiquer avec le serveur
  // qui va nous fournir les données.
  const url = "https://api.freecurrencyapi.com/v1/latest?apikey="+apikey+"&base_currency="+baseCurrency

  // des trucs un peu compliqués
  const request = UrlFetchApp.fetch(url)
  const response = JSON.parse(request.getContentText())
  const target = response.data[targetCurrency]

  // on insère le taux de change obtenu dans la sheet
  sheet.getRange("B5").setValue(target)
}

Voici le résultat obtenu en exécutant le script :

C’est pas mieux ça ? Maintenant, nous avons juste à exécuter le script pour avoir un taux de change à jour dans notre document.

4 Conclusion

Les API facilitent la communication entre programmes.
Elles permettent de récupérer facilement des données (ex. : images de chats, taux de change).
Elles font gagner du temps et simplifient les tâches quotidiennes.
Accès à des données en temps réel avec un peu de code.