O que é uma API assíncrona?

Em vez do mecanismo de solicitação-resposta imediata de APIs síncronas, as APIs assíncronas são baseadas em eventos. Isso significa que, quando seu aplicativo usa uma API assíncrona, ele não precisa pesquisar ou saber quando solicitar dados, já que ele assina um fluxo de eventos e receberá eventos à medida que eles se tornarem disponíveis.

Por exemplo, uma API de pedidos baseados em HTTP pode expor uma operação 'GET' no caminho '/orders'. Como consumidor da API, seu aplicativo precisaria fazer solicitações repetidas para o caminho '/orders', a fim de saber quando há novos pedidos.

Em comparação, como consumidor de uma API assíncrona, seu aplicativo assinaria o fluxo de eventos de pedidos e receberia novos eventos de pedido conforme eles chegam.

O que é AsyncAPI?

AsyncAPI é uma especificação para descrever APIs assíncronas, semelhante à maneira como a OpenAPI é uma especificação para descrever APIs HTTP síncronas.

A diferença chave é que enquanto a OpenAPI descreve caminhos e a solicitação e resposta para uma operação, a AsyncAPI descreve canais que contêm eventos juntamente com a estrutura de um evento.