Définition
Une API est un contrat entre systèmes : envoyez une requête dans ce format et vous obtiendrez cette réponse. C’est ainsi qu’un logiciel parle à un autre sans qu’une personne recopie des valeurs d’un écran à l’autre.
Ce qu’une API signifie pour une entreprise, pas pour un développeur
Retirez le vocabulaire technique et une API est une entente publiée : demandez-moi de cette façon, et je répondrai dans ce format, chaque fois.
Cette fiabilité est tout l’enjeu. Parce que le contrat est défini et versionné, un système peut dépendre d’un autre sans personne au milieu, et sans que l’arrangement casse chaque fois que quelqu’un redessine un écran. C’est pourquoi « y a-t-il une API ? » est l’une des questions les plus rentables à poser avant d’acheter un logiciel d’affaires, et l’une des moins souvent posées.
Un logiciel sans API est un logiciel que vos données ne peuvent pas quitter, sauf par des exportations lancées à la main. C’est une contrainte stratégique bien avant d’être une contrainte technique.
Pourquoi cela compte plus qu’il n’y paraît
Chaque étape manuelle où une personne lit une valeur dans un système et la saisit dans un autre existe parce que ces systèmes ne sont pas reliés. La ressaisie est le coût visible. Les coûts invisibles sont plus lourds : la faute de frappe que personne n’attrape, le délai pendant lequel la mise à jour attend qu’on s’en occupe, et les deux systèmes qui se contredisent désormais sur le même client.
Les API suppriment la catégorie de problème plutôt que ses occurrences. Quand votre CRM peut demander directement à votre système comptable si une facture a été payée, personne n’a à vérifier, à se souvenir ou à rapprocher.
Les questions à poser à un fournisseur
Avant de signer, et par écrit :
Y a-t-il une API, et est-elle incluse ? Certains fournisseurs la réservent à un forfait supérieur. Cet écart de prix appartient à votre comparaison, car le payer plus tard n’est plus facultatif une fois que vous dépendez du système. Que permet-elle réellement ? Un accès en lecture seule est courant et bien moins utile qu’il n’y paraît. Confirmez que vous pourrez écrire les données que vous devrez écrire. Quelles sont les limites ? Les limites de débit et les quotas déterminent si une synchronisation nocturne de 40 000 enregistrements est possible ou prend onze heures. Comment les changements sont-ils gérés ? Un fournisseur qui versionne son API et annonce ses retraits est un fournisseur dont vous pourrez entretenir l’intégration. Comment fonctionne l’authentification, et qui détient les identifiants ? La question devient urgente le jour où la personne qui a tout configuré s’en va.
L’approche Automathing
Nous traitons la disponibilité d’une API comme un critère d’approvisionnement plutôt que comme un détail technique, parce qu’un système qu’on ne peut pas relier contraint toutes les décisions qui suivent. Quand un système n’a réellement aucune API, nous chiffrons franchement ce que coûtent les contournements sur trois ans. Cette comparaison change généralement la décision d’achat, et elle vaut mieux avant le contrat qu’après.
Foire aux questions
Quelle différence entre une API et une intégration ?
L’API est l’interface offerte par un système ; l’intégration est ce que vous construisez avec. Le fournisseur fournit l’API, c’est-à-dire la possibilité de connexion. L’intégration est le lien concret et fonctionnel entre deux systèmes, y compris la logique de ce qui se synchronise, quand, et ce qui arrive en cas d’échec.
Comment savoir si notre logiciel a une API ?
Consultez la documentation développeur du fournisseur, demandez directement à votre gestionnaire de compte, ou cherchez « API » ou « developers » sur son site. Beaucoup de systèmes ont des API dont leurs utilisateurs quotidiens n’ont jamais entendu parler. Une documentation publique et à jour est généralement bon signe quant au sérieux du soutien.
Et si un système n’a pas d’API ?
Options par ordre de préférence : vérifier s’il existe déjà un connecteur d’intergiciel ou de plateforme d’intégration ; interroger le fournisseur sur sa feuille de route, que la demande influence ; recourir à des exportations et importations de fichiers planifiées si le processus tolère un délai ; ou se rabattre sur la RPA. Si rien ne fonctionne et que le système est central, c’est un véritable argument pour le remplacer.
Les API présentent-elles un risque de sécurité ?
Ce sont des points d’accès, exigeant la même discipline que les autres : des identifiants délimités n’accordant que le nécessaire, des clés régulièrement renouvelées et stockées correctement plutôt que collées dans un chiffrier, et une journalisation des accès. Une API bien gérée est généralement plus sûre que ce qu’elle remplace, à savoir souvent une personne qui fait circuler une exportation par courriel.