À propos de ce cours
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)
- Créez un projet
flutter create api_demo, ajoutezhttpet la permission internet Android. - Collez la mini-application et testez les quatre boutons. Notez le code de statut de chaque réponse (ajoutez un
print(response.statusCode)). - Modifiez
fetchTodospour ne récupérer que les tâches de l'utilisateur 2 (paramètre?userId=2). - Coupez le Wi-Fi de l'émulateur et appuyez sur GET : quel message s'affiche ? Pourquoi le
try / catchest-il indispensable ? - Défi : ajoutez un
TextFieldpour saisir le titre de la tâche envoyée en POST.
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 !