Passer au contenu principal

Qu'est-ce qu'une API ? 🤔

Lorsque vous commencez à apprendre le codage, vous entendez souvent le mot « API ». Mais il peut être difficile de comprendre ce qu'est exactement une API. Dans ce guide, nous allons expliquer les API de manière très simple !

Comparer les API à la vie quotidienne ?​

Comparons une API à un restaurant.

L'histoire du restaurant 🍽️​

Quand vous allez au restaurant :

  1. Client (vous) : Vous voulez commander un plat
  2. Serveur : Prend votre commande et la transmet à la cuisine
  3. Cuisine : Prépare le plat
  4. Serveur : Apporte le plat terminé au client

Ici, le serveur joue exactement le rôle d'une API !

Client(App) → Serveur(API) → Cuisine(Serveur)
                 ↓
Client(App) ← Serveur(API) ← Plat terminé(Données)

Définition formelle de l'API​

API (Application Programming Interface)

Elle joue le rôle de pont qui permet aux programmes de communiquer et d'échanger des informations.

Comprendre avec des exemples réels​

Exemple 1 : Application météo ☀️​

Lorsque vous ouvrez une application météo, la météo du jour s'affiche :

1. L'application météo demande au serveur météo « Donne-moi la météo de Séoul aujourd'hui ! »
2. L'API transmet cette demande
3. Le serveur recherche les informations météo
4. L'API reçoit les informations et les transmet à l'application
5. L'écran de l'application affiche « Séoul, Ensoleillé, 23°C »

Exemple 2 : Connexion 🔐​

Lorsque vous vous connectez à un autre site web avec votre compte Google :

1. Le site web demande à Google « Vérifie cette personne »
2. L'API Google vérifie les informations de l'utilisateur
3. Si vérifié, répond « OK » au site web
4. Connexion terminée !

Exemple 3 : Application de carte 🗺️​

La raison pour laquelle vous pouvez voir une carte dans une application de livraison :

L'application de livraison ne crée pas de carte directement,
Elle utilise l'API Google Maps pour obtenir la carte !

À quoi ressemble une requête API ?​

Faire une requête à une API ressemble à entrer une adresse :

https://api.weather.com/weather?city=Seoul
              ↑              ↑         ↑
        Adresse serveur  Que voulez-vous ?  Où ?

Avantages des API 🌟​

1. Pas besoin de réinventer la roue​

Vous pouvez utiliser des fonctionnalités déjà bien faites via des API.

Exemples :

  • Fonction de paiement : Utilisation de l'API Stripe
  • Fonction de carte : Utilisation de l'API Google Maps
  • Fonction de connexion : Utilisation de l'API de connexion Google/Facebook

2. Échanger des informations en toute sécurité​

C'est sûr car vous n'accédez qu'à travers l'API sans accéder directement à la base de données.

3. Plusieurs programmes peuvent l'utiliser ensemble​

Les applications pour smartphone, les sites web et les applications pour tablette peuvent tous utiliser la même API.

Types d'API Web​

REST API (Le plus courant)​

C'est la méthode API la plus utilisée sur le web.

Caractéristiques :

  • Requête par URL
  • Simple et facile à apprendre
  • Utilisé par la plupart des services web

Exemple :

Obtenir(Lecture) :  GET https://api.example.com/users
Créer(Écriture) :   POST https://api.example.com/users
Modifier :          PUT https://api.example.com/users/123
Supprimer :         DELETE https://api.example.com/users/123

GraphQL​

C'est une méthode qui permet de demander exactement les données dont vous avez besoin.

SOAP​

C'est une ancienne méthode d'API. Elle n'est pas beaucoup utilisée de nos jours.

Essayer d'utiliser une API​

Vous pouvez essayer d'utiliser une vraie API avec l'outil API Tester de notre site !

Pratique simple​

  1. Aller sur API Tester
  2. Entrez dans l'URL : https://api.github.com/users/github
  3. Sélectionnez GET pour la méthode
  4. Cliquez sur le bouton Send !

Vous pourrez obtenir les informations publiques de GitHub.

À quoi ressemble une réponse API ?​

Les API envoient généralement des données au format JSON :

{
  "name": "GitHub",
  "location": "San Francisco",
  "public_repos": 344
}
Astuce

Vous vous demandez ce qu'est JSON ? Consultez le document Comprendre le format de données JSON !

Exemples d'utilisation pratique​

Créer un blog​

Voir la liste des articles de blog :
GET https://myblog.com/api/posts

Créer un nouvel article :
POST https://myblog.com/api/posts

Créer une boutique en ligne​

Voir la liste des produits :
GET https://myshop.com/api/products

Ajouter au panier :
POST https://myshop.com/api/cart

Résumé des termes clés​

TermeSignificationExemple
Requête (Request)Demander quelque chose au serveur« Donnez-moi les informations météo »
Réponse (Response)La réponse envoyée par le serveur« Séoul est ensoleillé »
Point de terminaison (Endpoint)L'adresse de l'API/api/weather
Méthode (Method)Quelle action effectuerGET, POST, PUT, DELETE
JSONLe format d'échange de données{"city": "Seoul"}

Questions fréquemment posées (FAQ)​

Q1 : Les API sont-elles gratuites ?​

R : Cela dépend de chaque API !

  • API gratuite : Données publiques, GitHub, etc.
  • API partiellement gratuite : Gratuit jusqu'à un certain nombre de fois par jour (Google Maps, etc.)
  • API payante : Système de paiement, données premium, etc.

Q2 : Comment créer une API ?​

R : Vous devez apprendre la programmation backend.

  • Node.js + Express
  • Python + Django/Flask
  • Java + Spring Vous pouvez créer des API en apprenant ces technologies !

Q3 : Qu'est-ce qu'une clé API ?​

R : C'est comme un mot de passe qui vous permet d'utiliser l'API.

https://api.example.com/data?key=YOUR_API_KEY_HERE

Q4 : Que faire si une erreur se produit ?​

R : L'API vous informe avec des codes d'erreur :

  • 200 : Succès !
  • 404 : Introuvable
  • 500 : Erreur serveur

Pour plus de détails, consultez le Guide des codes d'état HTTP !

Prochaines étapes 🚀​

Si vous avez compris les bases des API :

  1. ✅ Comprendre le format de données JSON - Comment les API échangent des données
  2. ✅ API Tester - Utiliser directement les API
  3. ✅ Guide des codes d'état HTTP - Comprendre les codes de réponse API
  4. ✅ Convertisseur cURL - Convertir les requêtes API en différents formats

Conclusion​

Les API ne sont pas difficiles ! Considérez-les comme la façon dont les programmes communiquent entre eux.

Comme un serveur dans un restaurant, l'API :

  • Reçoit notre demande
  • La transmet au serveur
  • Et rapporte le résultat

Comprenez-vous maintenant ce qu'est une API ? 🎉