gauvainboiche
57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# Module 3 — Exercices : Flask & Requests
|
|
|
|
Fil rouge : une **API d'inventaire** en Flask, puis sa **consommation** avec la bibliothèque `requests`.
|
|
|
|
---
|
|
|
|
## Consignes communes à tous les exercices
|
|
|
|
**Usage de l'IA — transparence obligatoire.**
|
|
L'IA générative n'est **pas interdite**, mais son usage doit être **assumé et documenté**. Chaque rendu **doit obligatoirement contenir un fichier `USAGE-IA.md`**. Sans ce fichier, le rendu est **incomplet**.
|
|
|
|
`USAGE-IA.md` doit préciser : (1) les **outils utilisés** et pour quelles parties, (2) l'**aide obtenue** (avec un exemple de prompt), (3) ce que vous avez **accepté** et *pourquoi vous l'avez compris/validé*, (4) ce que vous avez **refusé ou corrigé** et *pourquoi*, (5) ce que vous avez **appris**.
|
|
|
|
> Aucune IA utilisée ? Déclarez-le explicitement.
|
|
|
|
**Règle d'or : vous devez pouvoir expliquer et justifier chaque ligne de votre rendu.** Gabarit en annexe.
|
|
|
|
**Pré-requis :** environnement virtuel activé, `pip install flask requests`.
|
|
|
|
---
|
|
|
|
## Exercice 3.1 — Première API Flask en lecture
|
|
|
|
**Compétences visées :** routing Flask, réponses JSON (`jsonify`), code **404**.
|
|
|
|
**Consignes :**
|
|
1. Créez une application Flask avec une liste d'équipements en mémoire (`id`, `hostname`, `ip`).
|
|
2. `GET /api/equipements` → renvoie `{"equipements": [...]}` en JSON.
|
|
3. `GET /api/equipements/<int:equipement_id>` → renvoie l'équipement, ou `{"erreur": "..."}` avec le code **404** s'il n'existe pas.
|
|
4. Lancez le serveur et testez dans le navigateur ou avec `curl`.
|
|
|
|
**Livrables :** `app.py`, `USAGE-IA.md`.
|
|
|
|
**Critères d'évaluation :** routes correctes (statique + dynamique), sérialisation JSON, gestion du 404.
|
|
|
|
|
|
## Annexe — Gabarit `USAGE-IA.md`
|
|
|
|
```markdown
|
|
# Usage de l'IA — Exercice X.Y
|
|
|
|
## 1. Outils utilisés
|
|
(Quel(s) outil(s), pour quelles parties. Ou : « aucune IA utilisée ».)
|
|
|
|
## 2. Aide obtenue
|
|
(Ce que l'IA a proposé. Exemple de prompt : « … »)
|
|
|
|
## 3. Ce que j'ai accepté
|
|
(Ce que j'ai repris et pourquoi je l'ai compris et validé.)
|
|
|
|
## 4. Ce que j'ai refusé ou corrigé
|
|
(Ce que j'ai écarté / modifié, et pourquoi.)
|
|
|
|
## 5. Ce que j'ai appris
|
|
(Ce que je retiens, ce que je ferais autrement.)
|
|
```
|