API : définition simple

À retenir

• Vous n’écrivez pas l’API vous-même : vous choisissez quels outils relier et quelles données doivent circuler.
• Un paiement, un agenda, un stock ou une fiche Google passent presque toujours par une API.
• Une API bien conçue demande une clé d’accès : la sécurité se décide dès la conception.

Une API en trois temps

Vous passez commande au serveur, il la transmet à la cuisine, puis vous rapporte le plat. Vous n’entrez jamais en cuisine, et la cuisine n’a pas besoin de connaître votre table. L’API joue le rôle du serveur. Voici la même scène lors d’un paiement en ligne.

Un paiement en ligne, étape par étape

1. La demande. Un client clique sur « Payer ». Votre site envoie une demande à l’API de la banque, avec le montant et le numéro de commande.
   • Qui demande : votre site
   • Ce qui est demandé : débiter 89 €
   • À quelle adresse : celle de l’API de la banque
2. Le traitement. L’API vérifie que la demande est autorisée grâce à une clé d’accès, puis la transmet au service de paiement qui fait le travail de son côté.
   • Une clé d’accès prouve qui demande
   • Le service travaille de son côté
   • Vos données restent chez vous
3. La réponse. L’API renvoie le résultat : paiement accepté ou refusé. Votre site affiche la confirmation et enregistre la commande, sans intervention humaine.
   • Réponse en quelques secondes
   • Accepté, refusé ou erreur
   • Le site réagit automatiquement

Des API au quotidien

Voici six situations qu’une entreprise rencontre, avec ce qui se passe en coulisses.

Les types d’API expliqués

Voici les six termes que vous entendrez le plus souvent en réunion.

API REST

Le format le plus répandu. Le logiciel demande une information à une adresse web précise et reçoit la réponse, le plus souvent au format JSON, un texte lisible par les machines.

• Standard des sites et applications actuels
• Une adresse par type d’information
• Simple à brancher à un autre outil

Webhook

L’inverse d’une demande : c’est l’autre logiciel qui vous prévient dès qu’il se passe quelque chose, par exemple « paiement reçu ». C’est le principe du webhook.

• Plus besoin de vérifier toutes les minutes
• Idéal pour les notifications
• Envoi automatique, en temps réel

API GraphQL

Une variante où le logiciel précise exactement les champs dont il a besoin, et rien de plus. Pratique pour une application mobile qui économise les données.

• Une seule demande pour plusieurs informations
• Réponses allégées
• Plus technique à mettre en place

API SOAP

Un format plus ancien et très structuré, encore courant dans la banque, l’assurance et l’administration. On le rencontre surtout en se branchant à un système existant.

• Format XML, plus verbeux
• Fréquent dans les systèmes anciens
• Rarement choisi pour un nouveau projet

API publique

Accessible à tout développeur qui s’inscrit : cartes, météo, paiement, réseaux sociaux. On l’utilise avec une clé d’accès personnelle, parfois payante.

• Documentation en ligne
• Clé d’accès personnelle
• Quotas ou tarif selon l’usage

API privée ou partenaire

Réservée à votre entreprise et aux partenaires que vous choisissez. Elle relie votre site, votre logiciel métier et votre application mobile sans être ouverte au public.

• Construite sur mesure
• Accès contrôlé par vous
• Souvent la base d’un logiciel métier

3 signes qu’il en faut une

Vous avez à repérer le moment où elle fait gagner du temps. Ces trois situations ne trompent pas.

Vous ressaisissez les données

Une commande arrive par le site, puis vous la retapez dans votre logiciel de facturation. Chaque ressaisie prend du temps et crée des erreurs.

• Commandes copiées à la main
• Fiches clients en double
• Erreurs de montant ou d’adresse

Vous échangez des fichiers

Un export Excel le soir, un import le lendemain : vos outils ne se parlent qu’une fois par jour, et quelqu’un doit y penser.

• Exports et imports manuels
• Données en retard d’une journée
• Dépend d’une seule personne

Votre site ignore la réalité

Le site affiche un produit disponible alors qu’il est épuisé, ou un créneau libre alors qu’il est pris, parce qu’il ne lit pas vos outils.

• Stock non synchronisé
• Agenda non synchronisé
• Prix différents d’un outil à l’autre

Questions fréquentes

Que veut dire API ?

API signifie Application Programming Interface, en français interface de programmation d’applications. C’est la porte par laquelle un logiciel en demande un service à un autre, selon des règles précises : quoi demander, comment, et sous quelle forme la réponse revient.

Une API, c’est la même chose qu’un plugin ou une intégration ?

Non. Un plugin ajoute une fonction à un logiciel, par exemple un module de paiement sur un site. Une API est le canal par lequel deux logiciels échangent. Un plugin s’appuie souvent sur une API en coulisses, et une intégration est le fait de brancher deux outils, très souvent grâce à leurs API.

Une API est-elle sécurisée ?

Cela dépend de la façon dont elle est construite. Une API bien conçue demande une clé d’accès ou une authentification, limite ce que chaque accès peut lire ou modifier, chiffre les échanges (HTTPS) et garde une trace des appels. La clé d’accès se protège comme un mot de passe : elle ne doit jamais apparaître dans le code visible d’un site.

Combien coûte l’intégration d’une API ?

Cela dépend de ce qu’il faut relier. Brancher une API existante, comme un paiement ou un agenda, est souvent un travail court. Construire la vôtre sur mesure relève d’un projet de logiciel, chiffré poste par poste après le cadrage. Certains services facturent aussi leur API à l’usage. Chez Skyward, le devis détaillé arrive sous 24 h, après un appel de 30 minutes.

Mon logiciel actuel a-t-il une API ?

Pas toujours. Cherchez dans sa documentation ou ses réglages les mots « API », « développeurs », « intégrations » ou « webhooks ». S’il n’en propose pas, il reste l’échange de fichiers ou une autre solution : la faisabilité et le coût de la liaison sont déterminés pendant le cadrage, avant tout chiffrage.

Quelle différence entre une API et un webhook ?

Avec une API classique, c’est votre logiciel qui pose la question, quand il en a besoin. Avec un webhook, c’est l’autre logiciel qui vous prévient dès que quelque chose se produit. Les deux se combinent souvent : le webhook signale qu’une commande est payée, puis l’API va chercher le détail de la commande.

À lire aussi

• À quoi sert une API pour mon logiciel métier ?