Quelle est la différence entre une bibliothèque de fonctions et une API ?
Réponse courte
Une bibliothèque regroupe des fonctions réutilisables qu’un programme peut appeler. Une API définit comment un logiciel utilise les fonctions ou les données d’un autre composant ; elle peut être locale ou distante, par exemple une API web.
Comprendre
La bibliothèque fournit du code réutilisable
Une bibliothèque rassemble des fonctions ou des composants que l’on réutilise au lieu de les réécrire. Un programme appelle une fonction de cette bibliothèque, en lui donnant les paramètres prévus, puis exploite le résultat retourné. Sa documentation précise notamment les noms, les types attendus et les erreurs possibles.
L’API définit une interface d’échange
Une API, ou interface de programmation applicative, décrit comment un logiciel peut utiliser les fonctions d’un autre composant. L’interface fixe les opérations disponibles ainsi que le format des entrées et des réponses. Elle peut être locale, ou exposée à distance sous forme d’API web. Une API n’est donc pas nécessairement une bibliothèque installée dans le programme.
Dans l’entreprise fictive RéparaCycle, une bibliothèque locale pourrait fournir une fonction de calcul de moyenne. Pour connaître le stock d’une pièce, l’application peut interroger l’API distante du service de stock. Elle doit ensuite contrôler la référence, le type de la quantité, son unité et la fraîcheur de la réponse. Si le service ne répond pas, la disponibilité est inconnue ; elle ne vaut pas automatiquement zéro. Dans les deux cas, la documentation et des tests restent nécessaires pour vérifier que l’outil correspond au besoin.
Exemples
- Une bibliothèque locale fournit à un programme une fonction qui calcule la moyenne de 12, 15 et 18 ; le programme appelle cette fonction et reçoit 15.
- L’application de RéparaCycle demande à une API de stock la quantité de la référence P14 ; une réponse « 12 pièces » doit être distinguée d’un délai dépassé ou d’un champ manquant.
Pièges fréquents
- Dire qu’une API est forcément un service distant : une API peut être locale, tandis qu’une API web permet des échanges à distance.
- Assimiler la bibliothèque au contrat d’échange : la bibliothèque fournit des éléments réutilisables, alors que l’API précise comment un composant logiciel peut être utilisé.
Pourquoi ça marche
Les deux notions facilitent la réutilisation, mais elles décrivent des aspects distincts : un ensemble de code disponible et les règles d’accès à un composant.
