Introduction

Une API (Application Programming Interface) est une interface qui permet à deux applications de communiquer entre elles.
Dans le web, une API sert souvent à accéder à des données ou des fonctionnalités d’un serveur depuis une application (ex : site web, application mobile).

Exemples d’API :

• API Pokémon pour récupérer la liste des Pokémon,
• API météo pour obtenir la température d’une ville,
• API d’authentification pour vérifier l’identité d’un utilisateur.

🧩 Comment fonctionne une API ?

Une API fonctionne grâce à des requêtes HTTP (GET, POST, etc.) envoyées à une adresse (URL).
L’application cliente (ex : votre site) envoie une requête, l’API répond avec des données (souvent au format JSON).

Schéma simplifié :

INFO

Le client envoie une requête ➡️ L’API traite la requête ➡️ L'API interroge le serveur de données ➡️ Le serveur renvoie les données à l’API ➡️ L’API renvoie les données au client

🔎 Les principales méthodes HTTP

• GET : récupérer des données (ex : liste des Pokémon)
• POST : envoyer ou créer de nouvelles données (ex : ajouter un Pokémon)
• PUT : modifier ou remplacer des données existantes (ex : mettre à jour un Pokémon)
• DELETE : supprimer des données (ex : retirer un Pokémon)

Chaque méthode a un usage précis pour interagir avec l’API.

📚 Les concepts clés à retenir

• Endpoint : une URL spécifique pour accéder à une ressource (ex : /pokemons)
• Méthode HTTP : type de requête (GET, POST, PUT, DELETE…)
• Réponse : les données renvoyées par l’API (souvent en JSON)
• Clé d’API : identifiant pour accéder à certaines API (sécurité)

📌 Ce qu’il faut retenir

• Une API permet d’échanger des données entre applications.
• On communique avec une API via des requêtes HTTP.
• Les réponses sont généralement au format JSON.