Construire une API GraphQL avec Python et Strawberry en 2026

Vous allez construire une API GraphQL complète avec Python, Strawberry GraphQL 0.315.4 et FastAPI 0.136.1, prête pour la production en 30 minutes. Strawberry génère automatiquement le schéma GraphQL à partir de vos types Python, éliminant les fichiers de configuration redondants. Documentation officielle Strawberry.

Ce que vous allez construire et pourquoi en 2026

Une API GraphQL pour gérer un catalogue de livres avec requêtes (lecture), mutations (création, mise à jour, suppression) et documentation interactive GraphiQL. L'API tourne sur http://localhost:8000/graphql avec un playground pour tester chaque requête en temps réel. Prérequis : Python 3.10 ou supérieur, 4 Go de RAM minimum, macOS/Linux/Windows. Temps estimé : 30 minutes sur n'importe quelle machine récente. Guide de démarrage Strawberry.

Installation : commandes exactes à copier

mkdir graphql-livres && cd graphql-livres
python3 -m venv venv
source venv/bin/activate
pip install 'strawberry-graphql[fastapi]' fastapi uvicorn

Résultat attendu : Strawberry 0.315.4, FastAPI 0.136.1 et Uvicorn 0.46.0 s'installent. Erreur courante : ERROR: No matching distribution found for strawberry-graphql → vérifiez que Python ≥ 3.10 avec python3 --version.

Configuration : les fichiers et variables à définir

Créez le fichier main.py à la racine du projet. Aucune variable d'environnement n'est requise pour le développement local. Pour la production, définissez :

• DATABASE_URL : URL de connexion PostgreSQL (ex: postgresql://user:pass@localhost:5432/livres)
• SECRET_KEY : clé secrète pour l'authentification JWT
• ALLOWED_ORIGINS : domaines autorisés pour CORS (ex: https://monsite.com)

Créez un fichier .env :

DATABASE_URL=sqlite:///./livres.db
SECRET_KEY=votre-cle-secrete-changez-moi
ALLOWED_ORIGINS=http://localhost:3000

Le code du projet : construire l'API GraphQL complète

Créez main.py avec le code complet suivant :

import strawberry
from fastapi import FastAPI
from strawberry.fastapi import GraphQLRouter
from typing import Optional, List # --- Modèle de données en mémoire ---
@strawberry.type
class Livre: id: int titre: str auteur: str annee: Optional[int] = None # Base de données en mémoire pour le tutoriel
livres_db: List[Livre] = [ Livre(id=1, titre="Le Petit Prince", auteur="Antoine de Saint-Exupéry", annee=1943), Livre(id=2, titre="L'Étranger", auteur="Albert Camus", annee=1942), Livre(id=3, titre="Vingt Mille Lieues sous les mers", auteur="Jules Verne", annee=1870),
]
compteur_id = 3 # --- Queries (lecture) ---
@strawberry.type
class Query: @strawberry.field def livre(self, id: int) -> Optional[Livre]: for l in livres_db: if l.id == id: return l return None @strawberry.field def livres(self) -> List[Livre]: return livres_db @strawberry.field def livres_par_auteur(self, auteur: str) -> List[Livre]: return [l for l in livres_db if l.auteur.lower() == auteur.lower()] # --- Mutations (écriture) ---
@strawberry.type
class Mutation: @strawberry.mutation def creer_livre(self, titre: str, auteur: str, annee: Optional[int] = None) -> Livre: global compteur_id compteur_id += 1 nouveau = Livre(id=compteur_id, titre=titre, auteur=auteur, annee=annee) livres_db.append(nouveau) return nouveau @strawberry.mutation def modifier_livre(self, id: int, titre: Optional[str] = None, auteur: Optional[str] = None, annee: Optional[int] = None) -> Optional[Livre]: for l in livres_db: if l.id == id: if titre: l.titre = titre if auteur: l.auteur = auteur if annee is not None: l.annee = annee return l return None @strawberry.mutation def supprimer_livre(self, id: int) -> bool: global livres_db avant = len(livres_db) livres_db = [l for l in livres_db if l.id != id] return len(livres_db) < avant # --- Schéma et application ---
schema = strawberry.Schema(query=Query, mutation=Mutation)
graphql_app = GraphQLRouter(schema) app = FastAPI(title="API Livres GraphQL", version="1.0.0")
app.include_router(graphql_app, prefix="/graphql")

Chaque @strawberry.type définit un type GraphQL automatiquement. Les @strawberry.field deviennent des champs de query, les @strawberry.mutation des mutations. Le schéma est généré sans fichier de configuration supplémentaire.

Tester et valider que ça fonctionne

uvicorn main:app --reload

Ouvrez http://localhost:8000/graphql dans votre navigateur. Le playground GraphiQL s'affiche. Testez ces requêtes :

Lister tous les livres :

query { livres { id titre auteur annee }
}

Ajouter un livre :

mutation { creerLivre(titre: "Les Misérables", auteur: "Victor Hugo", annee: 1862) { id titre }
}

Chercher par auteur :

query { livresParAuteur(auteur: "Victor Hugo") { id titre annee }
}

Si vous voyez les résultats JSON sous le playground, l'API fonctionne. Erreur courante : "Cannot query field \"livres\" on type \"Query\"" → vérifiez que @strawberry.field est bien au-dessus de chaque méthode de Query.

Déployer et utiliser en production

Pour la production, passez de SQLite à PostgreSQL avec SQLModel et lancez avec Gunicorn + Uvicorn workers :

pip install gunicorn sqlmodel psycopg2-binary
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000

Pour Docker, créez un Dockerfile :

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY .
CMD ["gunicorn", "main:app", "-w", "4", "-k", "uvicorn.workers.UvicornWorker", "-b", "0.0.0.0:8000"]

Pour mettre à jour Strawberry : pip install --upgrade 'strawberry-graphql[fastapi]'. Consultez les releases sur GitHub Releases.

Aller plus loin : 3 extensions concrètes

1. Authentification JWT — Ajoutez un middleware FastAPI qui vérifie le header Authorization: Bearer <token>. Utilisez python-jose pour encoder/décoder les tokens. Protégez chaque mutation en ajoutant un paramètre context au résolveur.

2. Pagination avec les connexions relay — Strawberry supporte strawberry.pagination depuis la version 0.315. Importez ListConnection depuis strawberry.pagination et remplacez List[Livre] par ListConnection[Livre] dans votre query pour obtenir une pagination curseur-compatible.

3. Souscriptions en temps réel — Ajoutez strawberry.subscription avec WebSocket pour notifier les clients quand un livre est ajouté. Utilisez async for dans votre générateur Python pour émettre les événements.