Déployer une API Flask : guide complet pour les débutants

Créer une API Flask, c’est simple. Mais la rendre accessible sur le web, c’est une autre histoire. Heureusement, ce guide va vous aider à la déployer étape par étape.

Même si vous débutez, vous pourrez suivre ce tutoriel sans problème. C’est le moment de passer de la théorie à la pratique !

– Pourquoi utiliser Flask pour créer une API ?

Flask est un micro-framework Python. Léger, rapide, et facile à prendre en main, il permet de créer des APIs REST en quelques lignes seulement.

Voici ses avantages principaux :

• Il est minimaliste : vous n’utilisez que ce dont vous avez besoin.
• Il est idéal pour les petits projets et les MVP.
• Il a une communauté active et une excellente documentation.

– Prérequis pour suivre ce tutoriel

Avant de commencer, vous devez avoir :

• Python 3 installé sur votre machine,
• Flask installé (pip install flask),
• Un compte sur Render (ou tout autre hébergeur cloud),
• Un éditeur de texte (Visual Studio Code est conseillé).

– Étape 1 : Créer une API Flask simple

Dans un dossier vide, créez un fichier app.py avec ce code :

pythonCopierModifierfrom flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/hello', methods=['GET'])
def hello():
    return jsonify({"message": "Bonjour depuis Flask !"})

if __name__ == '__main__':
    app.run(debug=True)

Lancez le serveur local :

bashCopierModifierpython app.py

– Étape 2 : Préparer pour le déploiement

Créez un fichier requirements.txt :

makefileCopierModifierFlask==2.3.3
gunicorn

Puis ajoutez un fichier Procfile (sans extension) :

makefileCopierModifierweb: gunicorn app:app

Ces deux fichiers sont nécessaires pour que l’hébergeur comprenne comment exécuter votre application.

– Étape 3 : Héberger votre API sur Render (ou autre plateforme cloud)

Nous allons utiliser Render car il est simple et offre un plan gratuit.

– 1. Créez un dépôt GitHub

• Mettez vos fichiers (app.py, requirements.txt, Procfile) dans un dépôt GitHub privé ou public.

– 2. Connectez Render à GitHub

• Créez un compte gratuit sur render.com.
• Cliquez sur « New Web Service ».
• Autorisez Render à accéder à vos dépôts.
• Sélectionnez le dépôt contenant votre API Flask.

– 3. Configurez le service

• Nom : api-flask-demo
• Branch : main
• Build Command : pip install -r requirements.txt
• Start Command : gunicorn app:app
• Environment : Python 3.11

Cliquez sur « Create Web Service ». Render va automatiquement déployer votre API Flask en ligne. L’URL finale ressemblera à :

arduinoCopierModifierhttps://api-flask-demo.onrender.com/api/hello

– Étape 4 : Tester votre API Flask en ligne

Vous pouvez maintenant accéder à votre endpoint depuis n’importe quel navigateur, Postman ou application mobile.

Par exemple :

bashCopierModifiercurl https://api-flask-demo.onrender.com/api/hello

Vous venez de déployer une API Flask sur le cloud !

– Prochaine étape : sécuriser et améliorer votre API

Maintenant que votre API est en ligne, pensez à :

• Ajouter des routes dynamiques,
• Connecter une base de données (SQLite, PostgreSQL),
• Gérer les erreurs proprement,
• Protéger vos routes avec un système de jeton (JWT),
• Documenter votre API avec Swagger ou Postman.