Premiers pas avec FastAPI

Pourquoi FastAPI ?

FastAPI est un framework Python pour construire des API web. Il s’appuie sur les annotations de type de Python : à partir de la signature de tes fonctions, il valide les données entrantes, convertit les réponses en JSON et génère une documentation interactive. Il repose sur Starlette (la partie web) et Pydantic (la validation). Ce cours utilise FastAPI 0.162 et Pydantic 2.14 (Python 3.10 ou plus récent). C’est aujourd’hui l’un des choix les plus populaires pour les API Python, y compris pour servir des modèles de machine learning.

Installation

Dans un environnement virtuel :

python -m venv .venv
source .venv/bin/activate          # Windows : .venv\Scripts\activate
pip install "fastapi[standard]"    # dernière version : FastAPI + serveur Uvicorn + outils CLI

Une première application

# main.py
from fastapi import FastAPI

app = FastAPI(title="API Boutique", version="1.0.0")  # l'objet application


@app.get("/")                 # opération de chemin : méthode GET sur "/"
def racine():
    # Un dict renvoyé est automatiquement converti en JSON
    return {"message": "Bienvenue sur l'API"}


@app.get("/sante")
def sante():
    return {"statut": "ok"}

On lance le serveur de développement, qui se recharge à chaque modification :

fastapi dev main.py
# -> Serving at: http://127.0.0.1:8000

En production, on utilise fastapi run main.py (sans rechargement automatique). Teste ensuite :

curl http://127.0.0.1:8000/sante
# {"statut":"ok"}

La documentation automatique

Ouvre http://127.0.0.1:8000/docs : FastAPI génère une interface Swagger UI qui liste tes routes et permet de les essayer (« Try it out »). Une autre présentation est disponible sur /redoc. Les deux lisent le schéma OpenAPI exposé en JSON sur /openapi.json, un standard que d’autres outils savent exploiter (génération de clients, tests).

Que fait le décorateur ?

@app.get("/") enregistre la fonction racine dans la table de routage de l’application : « quand une requête GET arrive sur /, appelle cette fonction ». Le décorateur renvoie la fonction inchangée. À la réception d’une requête, FastAPI cherche la route correspondante :

• trouvée → il appelle la fonction et sérialise le résultat en JSON (statut 200 par défaut) ;
• chemin inconnu → 404 avec {"detail": "Not Found"} ;
• chemin connu mais autre méthode (POST au lieu de GET) → 405 Method Not Allowed.

Il existe un décorateur par méthode HTTP : @app.get, @app.post, @app.put, @app.patch, @app.delete.

def ou async def ?

@app.get("/meteo")
async def meteo():
    # async def est utile si l'on attend une opération asynchrone :
    # données = await client_http.get(...)
    return {"ciel": "dégagé"}

Si ta fonction n’utilise pas await (ou utilise des bibliothèques bloquantes classiques), écris simplement def : FastAPI l’exécute dans un pool de threads sans bloquer le serveur. Mettre async def puis appeler du code bloquant (requête SQL synchrone, time.sleep) bloquerait toutes les requêtes.

À retenir

• app = FastAPI(), un décorateur par route, des fonctions qui renvoient des dict.
• fastapi dev pour développer, /docs pour explorer et tester.
• def par défaut, async def quand tu utilises await.