Aller au contenu

Comment utiliser des API REST dans une Application Front-End

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

  1. Ouvrez index.html dans un navigateur.
  2. 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 !

Étiquettes: