HOWTO · Flask

Comment envoyer une requête POST avec Flask

Découvrez les différences entre GET et POST, deux méthodes HTTP, puis apprenez à transmettre des données depuis un formulaire avec Flask.

Sur cette page

GET et POST sont des méthodes HTTP dont la sémantique diffère. Une requête GET demande une représentation au serveur et transporte souvent des paramètres dans l’URL. Une requête POST envoie des données dans le corps de la requête ; elle est couramment utilisée lorsqu’un formulaire transmet des données. POST ne chiffre ni ne dissimule ces données : HTTPS les protège pendant leur transit entre le client et le serveur, mais les clients, le serveur et les systèmes de journalisation peuvent toujours y accéder. Pour les informations sensibles, utilisez HTTPS et les mesures de protection adaptées à l’application.

Cet exemple conserve la cohérence entre la route, le champ du formulaire et la clé de récupération. Il affiche un formulaire à l’adresse /login ; sa soumission envoie le champ name à cette même route, où Flask le lit depuis request.form.

Comprendre GET et POST dans Flask

Lorsque vous ouvrez une page dans un navigateur, celui-ci envoie généralement une requête GET. Un formulaire peut utiliser POST lorsque sa soumission doit transmettre des données à traiter. Ces noms de méthode décrivent l’usage de la requête ; ils ne constituent pas des paramètres de sécurité. Les chaînes de requête peuvent apparaître dans l’historique du navigateur et dans les journaux, mais placer des valeurs dans le corps d’une requête POST ne garantit pas leur confidentialité et n’empêche pas leur journalisation.

Flask met la méthode reçue à disposition dans request.method. Une route qui accepte les deux méthodes peut afficher le formulaire pour GET et traiter la valeur soumise pour POST. Le navigateur et le serveur communiquent toujours par le même moyen de transport ; configurez HTTPS séparément pour protéger les données pendant leur transit.

Créer une route Flask qui accepte GET et POST

L’argument methods indique à Flask les méthodes acceptées par la route. Dans la fonction de traitement, examinez request.method pour choisir le comportement : renvoyez le formulaire pour GET et traitez les données soumises pour POST. Le formulaire est ainsi envoyé à la même route, ce qui rend son fonctionnement facile à suivre.

Créer et envoyer le formulaire HTML

L’attribut method="post" du formulaire sélectionne POST, et l’attribut name="name" du champ de saisie devient la clé utilisée par Flask pour récupérer sa valeur. L’action du formulaire pointe vers /login, comme la route présentée ci-dessous. Un bouton d’envoi soumet le formulaire ; aucun JavaScript n’est nécessaire pour cet échange élémentaire.

Lire les données soumises dans le formulaire

Pour une requête POST, request.form.get("name", "") récupère le champ soumis et renvoie une valeur de remplacement s’il est absent. Avant d’insérer cette valeur dans du HTML, la réponse l’échappe afin que du texte contenant, par exemple, des balises soit affiché comme du texte plutôt qu’interprété comme du balisage. Pour un véritable flux de création de compte ou de modification de données, ajoutez les contrôles adaptés de validation, d’authentification, d’autorisation et de protection contre les attaques CSRF ; choisir POST ne fournit pas ces protections à lui seul.

Exécuter et vérifier l’exemple

Installez Flask dans votre environnement avec python -m pip install Flask, enregistrez le code suivant dans app.py, puis démarrez le serveur de développement avec python -m flask --app app run. Le relevé d’exécution fourni indique que l’exemple Python a terminé son cas de réussite configuré avec le code de sortie 0 et sans sortie standard ; il ne consigne ni requête du navigateur ni réponse du serveur. Le code et les libellés visibles qu’il affiche restent en anglais.

from flask import Flask, request
from markupsafe import escape

app = Flask(__name__)


@app.route("/login", methods=["GET", "POST"])
def login():
    if request.method == "POST":
        name = request.form.get("name", "")
        return f"<h1>Hello, {escape(name)}</h1><a href='/login'>Back</a>"

    return """<!doctype html>
<html lang="en">
  <meta charset="utf-8">
  <title>Login form</title>
  <h1>Hello, this is the login page!</h1>
  <form action="/login" method="post">
    <label>Name: <input type="text" name="name"></label>
    <button type="submit">Submit</button>
  </form>
</html>"""

Ouvrez http://127.0.0.1:5000/login pour afficher le formulaire. Saisissez Ada et envoyez-le ; le navigateur transmet POST et la réponse affiche Hello, Ada. Dans les outils de développement du navigateur, ouvrez l’onglet Réseau pour confirmer la requête GET initiale et la requête POST du formulaire, puis examinez la méthode de requête et les données du formulaire. Le corps de la requête POST reste visible par le navigateur et le serveur. Le serveur de développement convient à l’apprentissage en local ; pour un déploiement, utilisez un serveur WSGI de production et HTTPS.