Qu'est-ce qu'une API ?

Une API (Application Programming Interface), ou Interface de Programmation d'Application en français, est une interface qui permet à un logiciel/application de communiquer avec d'autres logiciels/applications, serveurs ou bases de données.

En fait, une API est un pont de communication. Un programme client qui a besoin d'une information ou d'exécuter une action va envoyer une requête structurée à l'API. Cette dernière reçoit cette demande, interagit avec le système cible (comme une base de données) et renvoie la réponse au programme initial. Cette réponse est généralement au format JSON, le standard web moderne.

Les API permettent de récupérer des données (météo, bourses, etc.), d'automatiser des tâches, ou encore de connecter un backend à un frontend. Exemple : connecter Django Rest Framework à Vue/Nuxt js.

Comment intéragit avec une API en Python

Pour consommer une API web en Python, la méthode la plus populaire consiste à utiliser la bibliothèque tierce requests, bien qu'il soit possible de le faire avec la librairie standard urllib.

On va s'amuser avec la PokéAPI en récupérant les statistiques de Pikachu.

import requests

# L'URL de l'API que nous souhaitons interroger (ici, les données de Pikachu)
url = "https://pokeapi.co/api/v2/pokemon/pikachu"

# Nous envoyons une requête GET (pour récupérer des données)
reponse = requests.get(url)

# On vérifie si la requête a réussi (Code statut 200)
if reponse.status_code == 200:
    # On convertit la réponse JSON en dictionnaire Python
    donnees = reponse.json()

    # On affiche quelques informations, les clés name, weight et base_experience sont présentes dans la réponse JSON
    print(f"Nom : {donnees.get('name')}") # Nom : pikachu
    print(f"Poids : {donnees.get('weight')} hectogrammes") # Poids : 60 hectogrammes
    print(f"Expérience de base : {donnees.get('base_experience')}") # Expérience de base : 112
else:
    print(f"Erreur lors de la requête : {reponse.status_code}")

    
    
                PYTHON
            

Dans cet exemple, l'API nous renvoie une réponse formatée en JSON que la méthode json() de requests transforme en dictionnaire Python. Vous n'avez plus qu'à vous amusez en récupérer la structure de l'API.

Créer sa propre API en Python

Il faut savoir qu'il est possible de créer ses propres APIs en Python. Des frameworks permettent de construire des APIs :

FastAPI : très performant avec génération automatique de documentation
Flask : un micro-framework flexible
Django Rest Framework : parfait pour les projets de grande envergure

Nous avons d'ailleurs deux articles sur le sujet :

Créer une API REST en Python
Créer une API REST avec Django Rest Framework (attention, gros tuto à l'horizon)

api