FastAPI gère les données de formulaire HTML (Form) et les téléchargements de fichiers (File/UploadFile) — distincts des corps JSON, car ils utilisent des types de contenu différents (multipart/form-data). Les deux sont déclarés avec des types de paramètres spéciaux.
from fastapi import Form
@app.post("/login")
def login(username: str = Form(), password: str = Form()): # form fields, not JSON
# data comes as application/x-www-form-urlencoded or multipart/form-data
return {"username": username}
Utilisez Form() pour recevoir les champs de formulaire HTML (par exemple un formulaire de connexion). Remarque : une route peut utiliser soit un corps JSON soit des données de formulaire, pas les deux, car ce sont des types de contenu différents. (Nécessite l'installation de python-multipart.)
from fastapi import File, UploadFile
@app.post("/upload")
async def upload(file: UploadFile): # a single file
contents = await file.read() # read the file's bytes
file.filename # original name
file.content_type # MIME type
# save it:
with open(f"uploads/{file.filename}", "wb") as f:
f.write(contents)
return {"filename": file.filename, "size": len(contents)}
UploadFile est le type recommandé — c'est un fichier spooled (les fichiers volumineux vont sur le disque, pas tous en mémoire), avec des méthodes asynchrones (read, write, seek) et des métadonnées. Préférez-le aux bytes bruts pour tout sauf les minuscules fichiers.
@app.post("/upload-many")
async def upload_many(files: list[UploadFile]): # multiple files
return [f.filename for f in files]
@app.post("/profile")
async def profile(name: str = Form(), avatar: UploadFile = File()):
# combine form fields AND a file upload in one multipart request
...
if file.content_type not in ["image/jpeg", "image/png"]: # check type
raise HTTPException(400, "Invalid file type")
# also: limit file SIZE, sanitize filenames, scan content — uploads are untrusted input
Gérer les données de formulaire et les téléchargements de fichiers est un besoin courant et pratique — les formulaires de connexion, les téléchargements de photos de profil, les soumissions de documents et les API de traitement de fichiers l'exigent tous, et cela fonctionne différemment des corps JSON que FastAPI utilise par défaut.
Comprendre Form() pour les champs de formulaire et surtout UploadFile pour les téléchargements (l'approche recommandée, car elle spooled les fichiers volumineux sur le disque plutôt que de les charger entièrement en mémoire — important pour gérer les gros fichiers sans épuiser la RAM) est nécessaire pour ces fonctionnalités.
Également important est la responsabilité de sécurité qui accompagne les téléchargements : puisque les fichiers téléchargés sont des entrées non approuvées, valider leur type et leur taille, assainir les noms de fichiers et être prudent dans la façon dont vous les stockez/servez est essentiel pour éviter les vulnérabilités.
Savoir comment recevoir les champs de formulaire, gérer les téléchargements de fichiers uniques et multiples, combiner des formulaires avec des fichiers et valider les téléchargements en toute sécurité est une connaissance pratique pour construire des API réelles qui acceptent le contenu soumis par l'utilisateur.