À propos de ce cours
Presque toutes les applications mobiles que vos étudiants utilisent chaque jour (météo, livraison de repas, paiement mobile, réseaux sociaux, streaming) affichent des données qui ne sont pas stockées dans le téléphone: elles viennent d'un serveur, à travers une API. Ce chapitre apprend à une application Flutter à dialoguer avec ces serveurs.
Objectifs : à la fin du chapitre, l'étudiant sait :
- expliquer ce qu'est une API, une requête HTTP, un code de statut et le format JSON ;
- envoyer des requêtes GET, POST, PUT et DELETE depuis Flutter avec le package
http; - transformer du JSON en objets Dart (modèles) et inversement ;
- afficher des données distantes avec
FutureBuilderen gérant chargement, erreur et données ; - utiliser
Dioavec intercepteurs et un token d'authentification ; - interroger une API GraphQL avec
graphql_flutter; - organiser le code en couches (service, repository, UI) et gérer les erreurs proprement ;
- recevoir des données en temps réel avec un WebSocket.
Prérequis : widgets de base (Stateless/Stateful), async / await et Future en Dart, navigation, chapitres 22 (SQLite) et 23 (Firebase).
Matériel : Flutter SDK à jour, VS Code ou Android Studio, un émulateur ou un téléphone, une connexion internet. Optionnel : Postman, Bruno ou l'extension Thunder Client pour tester les API hors de Flutter.
| Leçon | Contenu | Durée indicative |
|---|---|---|
| 24.1 | Consommation d'API REST et GraphQL (leçon existante) | — |
| 24.2 | Comprendre les API : HTTP, méthodes, codes, JSON | 1 h 30 |
| 24.3 | Consommer une API REST avec http (CRUD) |
2 h |
| 24.4 | Modèles Dart et sérialisation JSON | 1 h 30 |
| 24.5 | Afficher les données : FutureBuilder et états |
2 h |
| 24.6 | Dio, intercepteurs et authentification |
2 h |
| 24.7 | Consommer une API GraphQL | 2 h |
| 24.8 | Architecture propre et gestion des erreurs | 1 h 30 |
| 24.9 | Temps réel avec les WebSockets | 1 h 30 |
| Projet | Application Météo complète | 4 h |
Configuration Android obligatoire. Ajoutez la permission internet dans android/app/src/main/AndroidManifest.xml, juste avant la balise <application>: <uses-permission android:name="android.permission.INTERNET" />. Sans elle, l'application fonctionne en mode debug mais aucune requête ne passe une fois installée en version release. Sur macOS, activez aussi « Outgoing Connections » dans les entitlements.
24.2 Comprendre les API : client, serveur, HTTP et JSON
L'idée en une image : le serveur au restaurant
Au restaurant, vous ne rentrez pas en cuisine : vous passez commande au serveur, qui transmet à la cuisine et vous rapporte le plat. Une API (Application Programming Interface) joue exactement ce rôle : votre application Flutter (le client) envoie une requête, le serveur la traite (souvent en interrogeant une base de données) puis renvoie une réponse.
Exemples de la vie de tous les jours
- Appli météo: demande les prévisions à une API météo (GET).
- Livraison de repas (Glovo, Uber Eats…): récupère la liste des restaurants (GET), passe la commande (POST), annule (DELETE), suit le livreur en temps réel (WebSocket, leçon 24.9).
- Paiement mobile (Orange Money, Wave…): envoie un transfert (POST) avec un token qui prouve votre identité (leçon 24.6).
- « Se connecter avec Google »: l'app parle à l'API d'authentification de Google.
- Instagram, GitHub, Shopify: proposent des API GraphQL pour ne demander que les champs utiles (leçon 24.7).
Vocabulaire essentiel
| Terme | Définition | Exemple |
|---|---|---|
| URL de base | Adresse du serveur | https://api.open-meteo.com |
| Endpoint | Chemin d'une ressource précise | /v1/forecast |
| Paramètres de requête | Filtres ajoutés après ? |
?latitude=48.85&longitude=2.35 |
| En-têtes (headers) | Informations sur la requête | Content-Type: application/json, Authorization: Bearer … |
| Corps (body) | Données envoyées (POST, PUT) | {"title": "Acheter du pain"} |
| Code de statut | Résultat de la requête | 200, 404, 500 |
Les méthodes HTTP (le CRUD des API)
Vous connaissez déjà le CRUD avec SQLite (chapitre 22). Une API REST utilise la même logique, avec des méthodes HTTP :
| Méthode | Action | CRUD | SQLite équivalent | Exemple concret |
|---|---|---|---|---|
| GET | Lire | Read | query() |
Afficher les produits d'une boutique |
| POST | Créer | Create | insert() |
Publier un commentaire |
| PUT / PATCH | Modifier (tout / en partie) | Update | update() |
Modifier sa photo de profil |
| DELETE | Supprimer | Delete | delete() |
Supprimer un article du panier |
Les codes de statut à connaître
| Famille | Signification | Codes fréquents |
|---|---|---|
| 2xx | Succès | 200 OK, 201 Created, 204 No Content |
| 3xx | Redirection | 301, 304 Not Modified |
| 4xx | Erreur du client (votre app) | 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests |
| 5xx | Erreur du serveur | 500 Internal Server Error, 503 Service Unavailable |
Astuce mémo : 4xx = c'est ta faute, 5xx = c'est la faute du serveur.
Le format JSON
JSON (JavaScript Object Notation) est le format texte utilisé par presque toutes les API. Il ressemble beaucoup à une Map<String, dynamic> en Dart :
{
"latitude": 48.86,
"longitude": 2.35,
"current": {
"time": "2026-11-22T12:00",
"temperature_2m": 9.4,
"wind_speed_10m": 14.2
}
}
| JSON | Dart |
|---|---|
objet { } |
Map<String, dynamic> |
tableau [ ] |
List<dynamic> |
"texte" |
String |
12 / 9.4 |
int / double (ou num) |
true / false |
bool |
null |
null |
Activité 24.2 — « Je suis le client » (sans code, 20 min)
- Ouvrez dans un navigateur :
https://api.open-meteo.com/v1/forecast?latitude=48.85&longitude=2.35¤t=temperature_2m,wind_speed_10m - Identifiez l'URL de base, l'endpoint et chaque paramètre.
- Remplacez latitude et longitude par celles de votre ville (cherchez-les sur une carte). Que change-t-il dans la réponse ?
- Ouvrez
https://jsonplaceholder.typicode.com/users/1puishttps://jsonplaceholder.typicode.com/users/999. Notez la différence. Dans les outils de développement du navigateur (F12, onglet Réseau), relevez le code de statut de chacune. - Par groupes de deux, choisissez une application de votre téléphone et listez trois actions de l'utilisateur, avec pour chacune la méthode HTTP probable (GET, POST, PUT, DELETE).
À retenir : une API = un contrat entre l'application et le serveur. L'app envoie une requête (méthode + URL + en-têtes + corps), le serveur renvoie un code de statut et, le plus souvent, du JSON.
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !