Qu'est-ce qu'une API? Guide en langage simple pour les créateurs d'apps

Une API (interface de programmation d'application) est une façon définie pour un logiciel de demander des données à un autre, ou de lui faire faire quelque chose. Votre app 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 pièces d'une app communiquent entre elles, et comment votre app utilise des services externes comme les paiements, le courriel, les cartes et l'IA.

Pourquoi les API comptent quand on construit avec l'IA

Presque toutes les apps utiles sont composées de pièces qui communiquent par API :

• À l'intérieur de votre app, les écrans du navigateur appellent l'API de votre propre serveur dorsal pour charger et sauvegarder les données.
• À l'extérieur de votre app, votre serveur dorsal appelle les API d'autres entreprises : Stripe pour les paiements, un fournisseur de courriel pour envoyer les reçus, un fournisseur de modèles d'IA pour générer du texte.

Quand vous demandez à un créateur IA de « prendre des paiements » ou d'« ajouter un résumé IA », il écrit en fait du code qui appelle une API. Connaître les bases vous aide à comprendre ce dont l'IA a besoin de votre part (généralement 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 dans la cuisine pour cuisiner. Vous lisez le menu, vous dites au serveur ce que vous voulez dans une forme que la cuisine comprend, et le serveur vous rapporte votre repas — ou vous dit que le plat est épuisé.

• Le menu, c'est la documentation de l'API : la liste de ce que vous pouvez demander et comment.
• Le serveur, c'est l'API : la seule façon convenue par laquelle les requêtes entrent et les réponses sortent.
• La cuisine, c'est l'autre système : vous n'avez pas besoin de savoir comment elle fonctionne à l'intérieur.
• Votre commande, c'est la requête; l'assiette, c'est la réponse.

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

Comment fonctionne une requête d'API web

La plupart des API que vous rencontrerez sont des API web qui fonctionnent avec HTTP, le même protocole que votre navigateur. Chaque requête comporte quelques parties :

Et chaque réponse comporte :

JSON (JavaScript Object Notation) est un format texte simple de noms et de valeurs entre accolades. C'est la façon standard dont les API web échangent des données.

REST : le style le plus courant

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

PUT existe aussi et remplace par convention 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 app plante, le code de statut est souvent l'indice le plus rapide. Un 401 d'un fournisseur de paiement signifie généralement une clé d'API manquante ou fausse; 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 serveurs dorsaux créés par l'IA.

Un exemple concret : la confirmation d'une réservation

Quand un client réserve une coupe dans une app de salon, plusieurs appels d'API peuvent se produire en une seconde ou deux :

1. La page de réservation dans le navigateur envoie POST /api/bookings avec le service, l'heure et les coordonnées du client à votre serveur dorsal.
2. Votre serveur dorsal vérifie que le créneau est libre, enregistre la réservation dans la base de données et renvoie 201 Created.
3. Votre serveur appelle l'API d'un fournisseur de courriel avec sa clé secrète : « envoie cette confirmation à lena@exemple.com ».
4. S'il y a un acompte, votre serveur demande à l'API du fournisseur de paiement de créer une session de paiement et envoie le client là.
5. Plus tard, le fournisseur de paiement appelle votre app pour dire que le paiement a réussi. Cet appel inverse est un webhook.

Les deux premières étapes sont votre propre API entre le frontal et le dorsal. Les étapes 3 à 5 sont des API tierces.

Termes courants expliqués

Erreurs courantes et idées reçues

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

Quoi demander à votre créateur IA

• « Quelles API externes cette app 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 point d'accès de notre API, ce qu'il fait et qui a le droit de l'appeler. »
• « Vérifie sur le serveur que l'utilisateur connecté est propriétaire de la réservation avant de la modifier ou de la supprimer. »
• « Si l'API de courriel échoue, sauvegarde quand même la réservation et journalise l'erreur. »
• « Utilise le mode test du fournisseur pour l'instant. »

Les API dans Mythex

Mythex peut construire votre propre API — dans le cadre d'une app web, ou comme serveur dorsal distinct en Node, Python (FastAPI), C# ou Java qui fonctionne à côté de votre frontal — et écrire le code qui appelle les services externes. Vous ajoutez leurs clés comme secrets de projet plutôt que dans le clavardage, et elles sont accessibles à votre app dans l'aperçu et une fois publiée. La documentation contient des recettes pour intégrer n'importe quelle API et construire un serveur dorsal d'API REST.

Questions