Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Flutter

Comprendre les API : client, serveur, HTTP et JSON

Ce qu'est une API, le cycle requête/réponse, les méthodes HTTP, les codes de statut et le format JSON, avec des exemples d'applications du quotidien....

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Ce qu'est une API, le cycle requête/réponse, les méthodes HTTP, les codes de statut et le format JSON, avec des exemples d'applications du quotidien.

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 FutureBuilder en gérant chargement, erreur et données ;
  • utiliser Dio avec 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.

Cycle requête / réponse entre une app Flutter et une API
Figure — Cycle requête / réponse entre une app Flutter et une API
Quand vous ouvrez une appli météo, elle envoie une requête du type « donne-moi la température actuelle à Paris » et reçoit une réponse en JSON qu'elle transforme en joli écran.

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)

  1. Ouvrez dans un navigateur : https://api.open-meteo.com/v1/forecast?latitude=48.85&longitude=2.35&current=temperature_2m,wind_speed_10m
  2. Identifiez l'URL de base, l'endpoint et chaque paramètre.
  3. Remplacez latitude et longitude par celles de votre ville (cherchez-les sur une carte). Que change-t-il dans la réponse ?
  4. Ouvrez https://jsonplaceholder.typicode.com/users/1 puis https://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.
  5. 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é ?