Qu'est-ce qu'une API (intégration par API) ?

Comment fonctionne une API ?

Une API est une sorte de guichet : un programme pose une question sous une forme convenue, l'autre répond. La plupart des applications web ont une API REST : un programme envoie une requête par internet à une adresse, par exemple pour récupérer toutes les nouvelles commandes, et reçoit les données dans un format lisible comme JSON. La documentation décrit les requêtes possibles ; de nombreux fournisseurs utilisent pour cela la spécification OpenAPI.

Exemples d'intégrations par API :

• les commandes de la boutique en ligne arrivent en comptabilité sous forme de factures ;
• un nouveau client dans le CRM est créé automatiquement dans le logiciel de facturation ;
• votre logiciel de comptabilité récupère les transactions bancaires via l'API de la banque (voir PSD2).

Intégration prête à l'emploi ou sur mesure ?

De nombreux logiciels proposent des intégrations standard avec des logiciels connus : vous les activez en quelques clics. S'il n'y en a pas, un développeur peut construire une intégration sur les deux API, ou vous utilisez un logiciel d'intégration qui relie les logiciels sans programmation. Entre partenaires commerciaux, les commandes et les factures sont souvent échangées par EDI.

À quoi faut-il faire attention ?

• L'API est-elle documentée publiquement, et est-elle incluse dans votre abonnement ou facturée en plus ?
• Quelles données pouvez-vous lire et écrire, et combien de requêtes par minute sont autorisées ?
• Qui gère l'intégration, et qui s'aperçoit qu'elle ne fonctionne plus ?