Qu'est-ce qu'une API ? Un guide simple pour les créateurs d'applications

Une API (interface de programmation d'application) est une manière définie pour un logiciel de demander à un autre des données ou de lui faire faire quelque chose. Votre application envoie une requête dans un format convenu — « donne-moi les réservations de demain », « débite cette carte de 20 € », « résume ce texte » — et l'autre système renvoie une réponse structurée. Les API sont la façon dont les éléments d'une application communiquent entre eux, et dont votre application utilise des services externes comme les paiements, l'e-mail, les cartes et l'IA.

Pourquoi les API comptent quand on crée avec l'IA

Presque toutes les applications utiles sont constituées d'éléments qui communiquent par API :

• À l'intérieur de votre application, les écrans du navigateur appellent l'API de votre propre backend pour charger et enregistrer les données.
• À l'extérieur de votre application, votre backend appelle les API d'autres entreprises : Stripe pour encaisser les paiements, un fournisseur d'e-mail pour envoyer les reçus, un fournisseur de modèles d'IA pour générer du texte.

Quand vous demandez à un créateur d'applications IA de « prendre des paiements » ou d'« ajouter un résumé IA », il écrit en réalité du code qui appelle une API. Comprendre les bases vous aide à savoir ce dont l'IA a besoin de votre part (en général un compte auprès de ce service et une clé d'API), où les choses peuvent mal tourner, et ce qu'elles coûteront.

Une analogie du quotidien

Pensez à un restaurant. Vous n'entrez pas en cuisine pour cuisiner. Vous lisez la carte, vous indiquez au serveur ce que vous voulez dans une forme que la cuisine comprend, et le serveur vous rapporte votre plat — ou vous dit qu'il est épuisé.

• La carte est la documentation de l'API : la liste de ce que vous pouvez demander et de la manière de le faire.
• Le serveur est l'API : l'unique façon convenue par laquelle les requêtes entrent et les réponses sortent.
• La cuisine est l'autre système : vous n'avez pas besoin de savoir ce qui s'y passe.
• Votre commande est la requête ; l'assiette est la réponse.

La cuisine peut changer ses fours et son personnel sans vous affecter, tant que la carte reste la même. C'est là la vraie valeur d'une API : elle permet à deux systèmes de travailler ensemble sans que l'un ait besoin de connaître la construction de l'autre.

Fonctionnement d'une requête d'API web

La plupart des API que vous rencontrerez sont des API web qui fonctionnent sur HTTP, le même protocole que votre navigateur. Chaque requête a quelques éléments :

Chaque réponse comporte aussi :

JSON (JavaScript Object Notation) est un format texte simple de noms et de valeurs entre accolades. C'est la manière standard d'échanger des données dans les API web.

REST : le style le plus courant

REST est une convention largement utilisée pour concevoir des API web. Chaque type d'élément a sa propre URL, et des méthodes standard indiquent ce que vous lui faites. Voici à quoi pourrait ressembler une API REST pour une application de réservation :

PUT existe aussi et, par convention, remplace un enregistrement entier, alors que PATCH ne modifie que les champs que vous envoyez.

Les codes de statut que vous verrez le plus souvent :

Quand votre application casse, le code de statut est souvent l'indice le plus rapide. Un 401 d'un prestataire de paiement signale en général une clé d'API absente ou erronée ; un 429 signifie que vous appelez trop souvent.

REST n'est pas le seul style — GraphQL et les API de type RPC existent aussi — mais REST est ce qu'utilisent la plupart des services et des backends créés avec l'IA.

Exemple concret : confirmer une réservation

Quand un client réserve une coupe dans une application de salon, plusieurs appels d'API peuvent avoir lieu en une ou deux secondes :

1. La page de réservation dans le navigateur envoie POST /api/bookings avec le service, l'horaire et les coordonnées du client à votre backend.
2. Votre backend vérifie que le créneau est libre, enregistre la réservation dans la base de données, et renvoie 201 Created.
3. Votre backend appelle l'API d'un fournisseur d'e-mail avec sa clé secrète : « envoie cette confirmation à lena@example.com ».
4. S'il y a un acompte, votre backend demande à l'API du prestataire de paiement de créer une session de paiement et envoie le client vers celle-ci.
5. Plus tard, le prestataire de paiement appelle votre application pour lui signaler que le paiement a réussi. Cet appel inversé est un webhook.

Les deux premières étapes relèvent de votre propre API entre le frontend et le backend. Les étapes 3 à 5 font appel à des API tierces.

Termes courants expliqués

Erreurs fréquentes et idées reçues

• Mettre des clés secrètes dans le frontend. Tout ce qui se trouve dans le code exécuté par le navigateur peut être vu par quiconque visite le site. Les clés secrètes doivent rester côté serveur, dans des variables d'environnement ou secrets.
• Coller des clés dans le chat. L'historique du chat peut être conservé. Utilisez plutôt la fonction de secrets de votre créateur, et renouvelez toute clé exposée.
• Supposer qu'une API est gratuite. Beaucoup d'API facturent à la requête ou à l'usage — les API de modèles d'IA facturent au token. Vérifiez les tarifs et fixez des plafonds de dépense. Voir comment utiliser les API de LLM.
• Ne pas gérer les échecs. Les services externes tombent en panne, dépassent les délais et atteignent leurs limites. Demandez des messages d'erreur raisonnables et des nouvelles tentatives.
• Faire confiance au navigateur. Votre propre API doit vérifier elle-même les permissions. Masquer un bouton n'empêche pas quelqu'un d'appeler directement l'endpoint.
• Utiliser des clés en production pendant les tests. Utilisez les clés du mode test jusqu'à ce que vous soyez prêt à lancer.

Ce qu'il faut demander à votre créateur d'IA

• « Quelles API externes cette application utilise-t-elle, et combien coûte chacune ? »
• « Appelle l'API de paiement uniquement depuis le serveur. Lis la clé depuis une variable d'environnement. »
• « Liste chaque endpoint de notre API, ce qu'il fait et qui est autorisé à l'appeler. »
• « Vérifie côté serveur que l'utilisateur connecté possède la réservation avant de la modifier ou de la supprimer. »
• « Si l'API d'e-mail échoue, enregistre quand même la réservation et journalise l'erreur. »
• « Utilise le mode test du prestataire pour le moment. »

Les API dans Mythex

Mythex peut créer votre propre API — dans le cadre d'une application web, ou comme backend séparé en Node, Python (FastAPI), C# ou Java fonctionnant à côté de votre frontend — et écrire le code qui appelle des services externes. Vous ajoutez leurs clés comme secrets de projet plutôt que dans le chat, et elles sont accessibles à votre application dans l'aperçu comme une fois publiée. La documentation propose des recettes pour intégrer n'importe quelle API et pour construire un backend d'API REST.

Questions