Les API REST sont essentielles pour connecter une application front-end à des services back-end et accéder à des données distantes. Dans ce tutoriel, nous allons explorer comment intégrer une API REST dans une application front-end simple.
1. Qu’est-ce qu’une API REST ?
Une API REST (Representational State Transfer) est une interface qui permet de communiquer avec un serveur en utilisant des requêtes HTTP comme :
- GET : Récupérer des données.
- POST : Envoyer des données.
- PUT : Mettre à jour des données.
- DELETE : Supprimer des données.
Les données échangées sont souvent au format JSON, ce qui les rend facilement manipulables.
2. Prérequis
Avant de commencer, assurez-vous d’avoir :
- Une connaissance de base en JavaScript.
- Un éditeur de texte (comme Visual Studio Code).
- Un navigateur avec une console de débogage (comme Chrome ou Firefox).
3. Création de l’application
a) Structure des fichiers
Créez les fichiers suivants :
project/
|-- index.html
|-- app.js
|-- style.css
b) Exemple de fichier HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>API REST Example</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="container">
<h1>Liste des Utilisateurs</h1>
<ul id="user-list"></ul>
</div>
<script src="app.js"></script>
</body>
</html>
4. Intégration de l’API REST
Nous utiliserons l’API publique de JSONPlaceholder pour récupérer une liste d’utilisateurs.
a) Envoi d’une requête GET
Ajoutez le code suivant dans app.js :
// URL de l'API
const apiUrl = 'https://jsonplaceholder.typicode.com/users';
// Élément HTML pour afficher les utilisateurs
const userList = document.getElementById('user-list');
// Fonction pour récupérer les données
async function fetchUsers() {
try {
const response = await fetch(apiUrl);
const users = await response.json();
// Afficher les utilisateurs
users.forEach(user => {
const listItem = document.createElement('li');
listItem.textContent = `${user.name} - ${user.email}`;
userList.appendChild(listItem);
});
} catch (error) {
console.error('Erreur lors de la récupération des utilisateurs :', error);
}
}
// Appeler la fonction
fetchUsers();
b) Style basique (optionnel)
Ajoutez le CSS suivant dans style.css :
body {
font-family: Arial, sans-serif;
background-color: #f4f4f4;
margin: 0;
padding: 0;
}
.container {
max-width: 800px;
margin: 50px auto;
background: #fff;
padding: 20px;
border-radius: 8px;
box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
}
h1 {
color: #333;
}
ul {
list-style: none;
padding: 0;
}
li {
background: #f9f9f9;
margin: 10px 0;
padding: 10px;
border: 1px solid #ddd;
border-radius: 4px;
}
5. Tester l’application
- Ouvrez
index.htmldans un navigateur. - Vous devriez voir une liste des utilisateurs récupérés depuis l’API.
6. Gérer les erreurs
Ajoutez une gestion des erreurs pour informer l’utilisateur en cas de problème :
async function fetchUsers() {
try {
const response = await fetch(apiUrl);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const users = await response.json();
users.forEach(user => {
const listItem = document.createElement('li');
listItem.textContent = `${user.name} - ${user.email}`;
userList.appendChild(listItem);
});
} catch (error) {
userList.innerHTML = '<li>Impossible de charger les utilisateurs.</li>';
console.error('Erreur :', error);
}
}
7. Aller plus loin
- Requêtes POST : Envoyer des données à l’API.
- Authentification : Ajouter des tokens ou des clés API.
- Bibliothèques : Utiliser Axios ou autre pour simplifier les requêtes.
- Frameworks : Intégrer dans des applications React, Vue.js ou Angular.
8. Conclusion
Ce tutoriel vous a montré comment consommer une API REST dans une application front-end. Les concepts explorés ici peuvent être appliqués à des projets plus complexes, en incluant des opérations CRUD complètes ou des intégrations avec des API authentifiées. Essayez de manipuler d’autres API pour améliorer vos compétences !