¿Qué es una API asíncrona?

En lugar del mecanismo de solicitud-respuesta inmediata de las API síncronas, las API asíncronas se basan en sucesos. Esto significa que cuando la aplicación utiliza una API asíncrona, no necesita sondear ni saber cuándo solicitar datos porque la aplicación se suscribe a una secuencia de sucesos y recibirá los sucesos a medida que estén disponibles.

Por ejemplo, una API de pedidos basada en HTTP puede exponer una operación 'GET' en la vía de acceso '/orders'. Como consumidor de la API, su aplicación necesitaría realizar repetidas solicitudes a la vía de acceso '/orders' para saber cuándo hay nuevos pedidos.

En comparación, como consumidor de una API asíncrona, la aplicación se suscribiría a la secuencia de sucesos de pedidos y recibiría nuevos sucesos de pedido a medida que llegaran.

¿Qué es AsyncAPI?

AsyncAPI es una especificación para describir las API asíncronas, de forma similar a como OpenAPI es una especificación para describir las API HTTP síncronas.

La diferencia clave es que mientras OpenAPI describe las vías de acceso y la solicitud y respuesta para una operación, AsyncAPI describe los canales que contienen sucesos junto con la estructura de un suceso.