C'est quoi une API · Code avec Martin

Découvre comment les sites web se parlent entre eux – et comment le tien peut demander la météo, des cartes ou de l'IA.

Un serveur entre deux cuisines

Imagine un restaurant. Toi (ton site web) tu veux commander, mais tu n’as pas le droit d’entrer dans la cuisine (un service externe – météo, cartes, IA). C’est pour ça qu’il y a le serveur – il prend ta commande, la porte en cuisine, et te ramène le plat fini.

Ce serveur s’appelle une API (Application Programming Interface). C’est une façon convenue pour que les programmes se demandent des données :

Ton site web envoie une requête (« Quel temps fera-t-il demain à Brno ? »).
L’API la transmet au service qui connaît la réponse.
Le service renvoie une réponse dans un format convenu.

Montre-moi : JSON – un langage commun

Les programmes se répondent au format JSON. Ça ressemble presque à un objet JavaScript, que tu connais déjà du Magicien :

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

Le texte est entre guillemets, les nombres non.
true/false tu les connais déjà des conditions.
Crochets = une liste, accolades = un objet.

Essaie maintenant – ouvre cette adresse dans ton navigateur (c’est une vraie API météo, gratuite, sans inscription) :

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Tu verras du JSON avec la météo actuelle à Brno. Pas de graphiques – juste des données pures. C’est à toi de construire les graphiques autour !

💡

Les APIs sont partout. Quand une app mobile te montre une prévision, un horaire de bus ou une carte, elle n’a presque jamais ces données elle-même – elle demande via une API. Maintenant tu apprends à faire pareil.

À toi 💪

Ouvre l’adresse ci-dessus dans ton navigateur et trouve la température actuelle et la vitesse du vent dans la réponse.
Essaie de changer latitude et longitude dans l’adresse pour les coordonnées de ta ville (trouve-les sur un service de cartes – clic droit → « Qu’y a-t-il ici ? »).
Note 2–3 idées pour ton projet sur quelles données externes seraient utiles sur ton site web :

🏫 Site web d'école – idées

Météo pour une sortie scolaire, une carte avec l’emplacement de l’école, un menu de cantine depuis l’API de la cantine (si elle en a une), vacances et congés scolaires.

🙋 Site web personnel – idées

Météo dans ta ville, une carte des endroits où tu es allé(e), un chatbot IA qui répond aux questions sur toi pour les visiteurs.

🌍 Journal de voyage – idées

Une carte avec des épingles pour tes voyages, météo à ta prochaine destination, conversion de devises pour ton budget voyage.

⚽ Site web de club – idées

Météo pour le match du week-end, une carte du terrain pour les équipes visiteuses, un assistant IA qui explique les règles du football.

✅

Vérifie : Tu peux expliquer ce qu’est une API (un serveur entre programmes) et reconnaître le JSON. Tu as vu une vraie réponse API dans ton navigateur.

Ce que tu retiens de cette leçon

API = une façon convenue pour que les programmes se demandent des données.
Les réponses arrivent en JSON – objets et listes comme en JavaScript.
Dans la prochaine leçon tu tireras des données d’une API directement dans ton site web avec fetch.