FastAPI 'Hello World'

1 Introduction à FastAPI

FastAPI est un framework web Python moderne pour construire des API. Il s'appuie sur Starlette pour la couche web et Pydantic pour la validation des données. Les indications de type ne sont pas seulement des décorations – elles pilotent l'analyse des requêtes, la sérialisation des réponses et la documentation automatique.

Rapide : Performances élevées comparables à Node et Go.
Rapide à coder : Des fonctionnalités sprintées avec un minimum de code répétitif.
Moins de bugs : Valide automatiquement les entrées et les sorties.
Basé sur les standards : Génère OpenAPI, Swagger UI et ReDoc prêts à l'emploi.

Quand vous êtes prêt, cliquez sur "Suivant" et nous allons lancer une application minimale localement.

2 Prérequis : Python & Pip

Confirmez que Python 3.7+ et pip sont installés :

python --version
pip --version

S'ils manquent, installez depuis python.org.

3 Configuration d'un Environnement Virtuel

Gardez les dépendances organisées avec un environnement virtuel.

python -m venv .venv

Activez-le :

# macOS/Linux
source .venv/bin/activate

# Windows (Invite de commandes)
.venv\Scripts\activate

Vous verrez (.venv) lorsqu'il sera actif.

4 Installer FastAPI et Uvicorn

Installez FastAPI et Uvicorn (le serveur ASGI) dans votre environnement virtuel :

pip install "fastapi[all]" uvicorn[standard]

L'extra [all] inclut Pydantic v2 et les dépendances optionnelles standard. Si vous préférez des installations légères, utilisez pip install fastapi uvicorn.

5 Créer main.py

Créez un fichier nommé main.py et ajoutez un point d'entrée basique :

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}

C'est tout – une importation, une application, une route. Les docstrings et les indications de type alimenteront les documents générés.

6 Lancer le Serveur avec Uvicorn

Démarrez le serveur avec le rechargement à chaud pendant le développement :

uvicorn main:app --reload

Ouvrez http://127.0.0.1:8000/ pour voir votre réponse JSON.

7 Explorer les Documents Interactifs

FastAPI sert automatiquement Swagger UI et ReDoc :

Swagger UI : /docs
ReDoc : /redoc
Schéma OpenAPI : /openapi.json

Vous pouvez tester le point d'entrée directement depuis les documents et voir les modèles de requête/réponse sans aucune configuration supplémentaire.

8 Ajouter une Route avec un Paramètre de Chemin

Mettez à jour main.py avec une route paramétrée :

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

Grâce aux indications de type, item_id sera validé comme un entier et documenté automatiquement.

9 Accepter un Corps de Requête (Pydantic)

Définissez un modèle et acceptez des charges utiles JSON :

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    # Normalement, vous stockeriez ceci ; ici, nous le renvoyons simplement.
    return item


@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: str | None = None):
    result = {"item_id": item_id}
    if q:
        result["q"] = q
    return result

FastAPI valide le JSON, impose les types et documente le modèle dans le schéma généré.

10 Lever et Gérer les Erreurs

Utilisez HTTPException pour des réponses d'erreur claires :

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    tags: list[str] = []


db: dict[int, Item] = {}


@app.post("/items/", response_model=Item)
def create_item(item: Item):
    new_id = len(db) + 1
    db[new_id] = item
    return item


@app.get("/items/{item_id}")
def read_item(item_id: int):
    item = db.get(item_id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found")
    return {"item_id": item_id, **item.dict()}

Essayer un ID manquant renvoie maintenant un JSON 404 propre : {"detail": "Item not found"}.

11 Prochaines Étapes et Déploiement

Épingler les dépendances : pip freeze > requirements.txt
Essayer le mode production : uvicorn main:app --host 0.0.0.0 --port 8000
Déployer sur Render, Fly.io, Railway, ou une VM avec Gunicorn + Uvicorn workers
Utiliser @app.exception_handler pour centraliser la mise en forme des erreurs
Sécuriser les points d'entrée avec OAuth2/JWT via fastapi.security

Vous avez maintenant une API fonctionnelle, la validation et des documents en direct. À partir de là, vous pouvez développer vos routes, couches et tests sans changer de framework.

Progression du Tutoriel