À retenir
- Sert uniquement à la lecture ou à l'exportation de données.
- Utilise majoritairement la méthode HTTP GET.
- Ne permet pas de modifier ou de supprimer des informations sur le serveur source.
Une API sortante est une interface qui permet à un programme de transmettre des informations vers l'extérieur ou de laisser d'autres systèmes consulter ses données. C'est comme un guichet d'information où les visiteurs peuvent venir lire des renseignements sans pouvoir modifier les registres du bâtiment.
Étymologie
Le terme API est l'acronyme anglais de Application Programming Interface (Interface de Programmation d'Application). L'adjectif sortante indique ici le sens de la communication : les données « sortent » du système source pour répondre à une demande de lecture, souvent via la méthode HTTP GET.
Exemples d'usage
- Une application météo qui interroge un serveur pour afficher les prévisions du jour.
- Un site e-commerce qui transmet le catalogue de ses produits à un comparateur de prix.
- L'affichage des derniers messages d'un réseau social sur un blog personnel.
Cas d'usage
On utilise principalement les API sortantes dans le cadre de la consultation de données (Open Data), de l'affichage de tableaux de bord ou de l'intégration de services tiers qui ne nécessitent pas de modifier la base de données d'origine.
Bonnes pratiques
Il est recommandé de mettre en place un système de cache pour ne pas saturer le serveur à chaque demande identique. Il est aussi essentiel d'utiliser des clés d'API pour contrôler qui accède aux données et limiter le nombre de requêtes par minute (rate limiting).
Synonymes
Antonymes
Conseil
Quand vous débutez, considérez l'API sortante comme un livre ouvert : vous pouvez y lire ce que vous voulez, mais vous n'avez pas de stylo pour écrire dessus. C'est le moyen le plus simple et le moins risqué de commencer à manipuler des données externes.
Questions fréquentes
Une API sortante est-elle sécurisée ?
Oui, car elle ne permet généralement pas de modifier le système. Cependant, il faut veiller à ce que les données exportées ne soient pas confidentielles sans une authentification appropriée.
Quelle est la différence avec une API entrante ?
L'API entrante reçoit des données pour modifier ou créer du contenu, tandis que la sortante ne fait que distribuer de l'information déjà existante.