À retenir
- Sert à recevoir des données ou des ordres venant de l'extérieur.
- Correspond généralement aux opérations d'écriture (création ou modification).
- Nécessite une surveillance de sécurité accrue.
Une API entrante est un point d'accès qui permet à un système extérieur d'envoyer des informations ou des commandes vers votre propre application. On peut comparer cela à une boîte aux lettres : n'importe qui (possédant la clé) peut y déposer un courrier pour que vous puissiez le lire et le traiter plus tard.
Étymologie
Le terme provient de l'acronyme anglais API (Application Programming Interface) associé à l'adjectif « entrante », qui qualifie le flux de données arrivant vers le serveur. Contrairement à une API de consultation, celle-ci modifie l'état du système.
Exemples d'usage
- Une application mobile qui envoie les coordonnées d'un nouvel utilisateur pour créer son compte (méthode
POST). - Un capteur de température connecté qui transmet ses relevés toutes les heures à une base de données centrale.
- Un site e-commerce qui met à jour le stock d'un produit suite à une livraison (méthode
PUTouPATCH).
Cas d'usage
On utilise les API entrantes dès qu'un système doit recevoir des données externes pour les enregistrer, les transformer ou déclencher une action spécifique. C'est le pilier de l'interconnectivité entre les logiciels (SaaS), les objets connectés et les applications mobiles.
Bonnes pratiques
Comme ces API permettent de modifier vos données, la sécurité est cruciale : il faut impérativement authentifier l'expéditeur (via une clé API ou un jeton), valider rigoureusement le format des données reçues pour éviter les injections malveillantes, et mettre en place une limitation de débit (rate limiting) pour éviter la saturation du serveur.
Synonymes
Antonymes
Conseil
Si vous développez une API entrante, ne faites jamais confiance aux données reçues. Imaginez que l'utilisateur extérieur puisse envoyer n'importe quoi : testez toujours la taille, le type et le contenu des informations avant de les traiter.
Questions fréquentes
Quelle est la différence avec une API sortante ?
Une API entrante reçoit des données envoyées par un tiers, alors qu'une API sortante est utilisée par votre système pour aller chercher des informations ailleurs.
Est-ce forcément du REST ?
Non, bien que le format REST (avec POST, PUT) soit le plus courant, une API entrante peut aussi utiliser GraphQL ou des Webhooks.