Qu'est-ce qu'une API asynchrone ?

Au lieu du mécanisme de demande-réponse immédiate des API synchrones, les API asynchrones sont basées sur des événements. Cela signifie que lorsque votre application utilise une API asynchrone, elle n'a pas besoin d'interroger ou de savoir à quel moment demander des données car votre application s'abonne à un flux d'événements et reçoit les événements dès qu'ils sont disponibles.

Par exemple, une API de commandes HTTP peut exposer une opération 'GET' sur le chemin '/orders'. En tant que consommateur de l'API, votre application devra faire des demandes répétées au chemin '/orders' pour connaître l'arrivée de nouvelles commandes.

En comparaison, en tant que consommateur d'une API asynchrone, votre application s'abonnera au flux d'événements des commandes et recevra de nouveaux événements de commande dès leur arrivée.

Qu'est-ce qu'AsyncAPI ?

AsyncAPI est une spécification utilisée pour décrire les API asynchrones, à l'instar d'OpenAPI qui est une spécification pour décrire les API HTTP synchrones.

La principale différence réside dans le fait que si OpenAPI décrit les chemins et la demande et la réponse d'une opération, AsyncAPI décrit les canaux qui contiennent des événements ainsi que la structure des événements.