Cosa è una API asincrona?

Invece di utilizzare il meccanismo di richiesta-risposta immediata delle API sincrone, le API asincrone sono basate su eventi. Ciò significa che quando l'applicazione dell'utente utilizza un'API asincrona, non è necessario eseguire un polling o sapere quando richiedere i dati perché l'applicazione dispone di una sottoscrizione a un flusso di eventi, e riceverà gli eventi man mano che diventano disponibili.

Ad esempio, un'API di ordini basata su HTTP potrebbe esporre un'operazione 'GET' sul percorso '/ordini'. Come consumer dell'API, l'applicazione dell'utente dovrebbe effettuare richieste ripetute al percorso '/ordini' per sapere quando ci sono nuovi ordini.

Per confronto, come consumer di un'API asincrona, l'applicazione dell'utente dovrebbe sottoscrivere il flusso di eventi degli ordini e ricevere gli eventi di nuovi ordini man mano che arrivano.

Che cosa è AsyncAPI?

AsyncAPI è una specifica per descrivere le API asincrone, analogamente a come OpenAPI è una specifica per descrivere le API HTTP sincrone.

La differenza chiave è che mentre OpenAPI descrive i percorsi e la richiesta e risposta per un'operazione, AsyncAPI descrive i canali che contengono gli eventi insieme alla struttura di un evento.