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

Consommer une API REST avec le package http

Envoyer des requêtes GET, POST, PATCH et DELETE depuis Flutter avec le package http, avec une mini-application de démonstration....

0 chapitres 0 QCM Accès gratuit

À propos de ce cours

Envoyer des requêtes GET, POST, PATCH et DELETE depuis Flutter avec le package http, avec une mini-application de démonstration.

Objectif : envoyer les quatre requêtes du CRUD depuis une application Flutter et lire la réponse.

API utilisée : JSONPlaceholder, une fausse API gratuite qui imite une vraie liste de tâches (/todos). Attention : elle simule les créations, modifications et suppressions (elle répond comme si c'était fait, mais ne garde rien).

Étape 1 : installer le package

flutter pub add http

Puis, en haut du fichier Dart :

import 'dart:convert';                 // jsonEncode / jsonDecode
import 'package:http/http.dart' as http;

Étape 2 : construire une URL proprement

// Simple
final url = Uri.parse('https://jsonplaceholder.typicode.com/todos/1');

// Avec des paramètres (encodés automatiquement, plus sûr)
final meteo = Uri.https('api.open-meteo.com', '/v1/forecast', {
  'latitude': '48.85',
  'longitude': '2.35',
  'current': 'temperature_2m',
});

GET : lire des données

Future<List<dynamic>> fetchTodos() async {
  final url = Uri.parse('https://jsonplaceholder.typicode.com/todos?_limit=10');
  final response = await http.get(url).timeout(const Duration(seconds: 10));

  if (response.statusCode == 200) {
    return jsonDecode(response.body) as List<dynamic>; // texte JSON -> List
  } else {
    throw Exception('Erreur serveur : ${response.statusCode}');
  }
}

Trois réflexes à retenir : await (la requête prend du temps), vérifier statusCode avant d'utiliser le corps, et jsonDecode pour transformer le texte en objets Dart.

POST : créer une ressource

Future<Map<String, dynamic>> createTodo(String title) async {
  final response = await http.post(
    Uri.parse('https://jsonplaceholder.typicode.com/todos'),
    headers: {'Content-Type': 'application/json; charset=UTF-8'},
    body: jsonEncode({'title': title, 'completed': false, 'userId': 1}),
  );

  if (response.statusCode == 201) {          // 201 = Created
    return jsonDecode(response.body);          // contient le nouvel id
  }
  throw Exception('Création impossible (${response.statusCode})');
}

PUT / PATCH : modifier

Future<void> markAsDone(int id) async {
  final response = await http.patch(
    Uri.parse('https://jsonplaceholder.typicode.com/todos/$id'),
    headers: {'Content-Type': 'application/json; charset=UTF-8'},
    body: jsonEncode({'completed': true}),    // PATCH : seulement le champ modifié
  );
  if (response.statusCode != 200) throw Exception('Modification échouée');
}

PUT remplace la ressource entière (il faut envoyer tous les champs), PATCH ne modifie que les champs envoyés.

DELETE : supprimer

Future<void> deleteTodo(int id) async {
  final response = await http.delete(
    Uri.parse('https://jsonplaceholder.typicode.com/todos/$id'),
  );
  if (response.statusCode != 200 && response.statusCode != 204) {
    throw Exception('Suppression échouée');
  }
}

Mini-application de démonstration

Cet écran teste les quatre méthodes et affiche le résultat brut. Il suffit de copier les fonctions ci-dessus dans le même fichier.

import 'package:flutter/material.dart';

void main() => runApp(const MaterialApp(home: CrudDemoPage()));

class CrudDemoPage extends StatefulWidget {
  const CrudDemoPage({super.key});
  @override
  State<CrudDemoPage> createState() => _CrudDemoPageState();
}

class _CrudDemoPageState extends State<CrudDemoPage> {
  String _resultat = 'Appuyez sur un bouton';
  bool _chargement = false;

  Future<void> _executer(Future<Object?> Function() action) async {
    setState(() => _chargement = true);
    try {
      final r = await action();
      setState(() => _resultat = r?.toString() ?? 'OK');
    } catch (e) {
      setState(() => _resultat = 'Erreur : $e');
    } finally {
      setState(() => _chargement = false);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Test CRUD API')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(children: [
          Wrap(spacing: 8, children: [
            ElevatedButton(onPressed: () => _executer(fetchTodos), child: const Text('GET')),
            ElevatedButton(onPressed: () => _executer(() => createTodo('Réviser Flutter')), child: const Text('POST')),
            ElevatedButton(onPressed: () => _executer(() async { await markAsDone(1); return 'Tâche 1 terminée'; }), child: const Text('PATCH')),
            ElevatedButton(onPressed: () => _executer(() async { await deleteTodo(1); return 'Tâche 1 supprimée'; }), child: const Text('DELETE')),
          ]),
          const SizedBox(height: 16),
          Expanded(
            child: _chargement
                ? const Center(child: CircularProgressIndicator())
                : SingleChildScrollView(child: Text(_resultat)),
          ),
        ]),
      ),
    );
  }
}

Activité 24.3 — « Mes premières requêtes » (45 min)

  1. Créez un projet flutter create api_demo, ajoutez http et la permission internet Android.
  2. Collez la mini-application et testez les quatre boutons. Notez le code de statut de chaque réponse (ajoutez un print(response.statusCode)).
  3. Modifiez fetchTodos pour ne récupérer que les tâches de l'utilisateur 2 (paramètre ?userId=2).
  4. Coupez le Wi-Fi de l'émulateur et appuyez sur GET : quel message s'affiche ? Pourquoi le try / catch est-il indispensable ?
  5. Défi : ajoutez un TextField pour saisir le titre de la tâche envoyée en POST.

Cet article vous a-t-il aidé ?