En bref
Une API (Application Programming Interface) est une façon pour deux programmes de se parler et d'échanger des données. Au lieu qu'un humain clique sur un site web, un programme envoie une requête à un autre programme et reçoit une réponse structurée. Quand votre application affiche la météo, envoie un e-mail ou interroge un modèle d'IA, elle appelle une API en arrière-plan. Les API sont les tuyaux qui relient le logiciel que vous construisez au reste du monde.
L'analogie du restaurant
Voyez une API comme un serveur. Vous n'allez pas en cuisine pour cuisiner ; vous donnez votre commande au serveur, il la porte en cuisine et vous rapporte votre plat. L'API est le serveur : vous envoyez une requête décrivant ce que vous voulez, et vous obtenez une réponse, sans jamais avoir à savoir comment la cuisine fonctionne à l'intérieur.
Requêtes et réponses
Une requête part vers une URL (l'endpoint), souvent avec quelques données attachées. La réponse revient le plus souvent en JSON, un format de données structuré. La plupart du temps, votre code ou votre agent IA gère les détails, mais la forme est toujours la même : vous demandez, vous recevez une réponse structurée.
{
"city": "Zurich",
"temperature": 18,
"condition": "cloudy"
}Les clés d'API et pourquoi elles comptent
Beaucoup d'API exigent une clé d'API, une chaîne secrète qui vous identifie et pilote souvent la facturation. Comme une clé peut vous coûter de l'argent si elle fuite, elle va dans un fichier .env et jamais dans du code committé. C'est la même discipline des secrets qui protège tout identifiant dans votre projet.
Confusions fréquentes des débutants
Quelques points font trébucher. Une API n'est pas un site web que vous visitez dans le navigateur ; c'est un service auquel votre programme parle, et visiter directement une URL d'API n'affiche souvent que des données brutes ou une erreur, ce qui est normal. Les "rate limits" sont une autre surprise : beaucoup d'API limitent le nombre de requêtes dans une fenêtre de temps, donc si des appels échouent soudainement, vous allez peut-être juste trop vite. Et différentes API utilisent des règles légèrement différentes d'authentification et de forme de requête, c'est pourquoi lire la documentation spécifique de l'API compte. La bonne nouvelle : votre agent IA lit ces docs et écrit le code de requête pour vous, pour que vous puissiez utiliser une nouvelle API en confiance sans en mémoriser les détails d'avance.