Co to jest asynchroniczny interfejs API?

Zamiast natychmiastowego mechanizmu typu żądanie-odpowiedź stosowanego w synchronicznych interfejsach API, asynchroniczne interfejsy API wykorzystują zdarzenia. Oznacza to, że gdy aplikacja korzysta z asynchronicznego interfejsu API, nie musi odpytywać ani wiedzieć, kiedy zażądać danych, ponieważ aplikacja subskrybuje strumień zdarzeń i odbiera zdarzenia w momencie ich udostępnienia.

Na przykład interfejs API zamówień wykorzystujący protokół HTTP może udostępniać operację 'GET' dla ścieżki '/orders'. Jako konsument synchronicznego interfejsu API aplikacja musiałaby okresowo powtarzać żądania dla ścieżki '/orders', aby dowiedzieć się, czy są dostępne jakieś nowe zamówienia.

Jako konsument asynchronicznego interfejsu API aplikacja subskrybuje strumień zdarzeń zamówień i odbiera nowe zamówienia w momencie ich wystąpienia.

Co to jest interfejs AsyncAPI?

Interfejs AsyncAPI jest specyfikacją opisującą asynchroniczne interfejsy API, podobnie jak interfejs OpenAPI jest specyfikacją opisującą synchroniczne interfejsy API HTTP.

Kluczowa różnica polega na tym, że podczas gdy interfejs OpenAPI opisuje ścieżki, żądanie i odpowiedź dla operacji, interfejs AsyncAPI opisuje kanały, które zawierają zdarzenia, wraz ze strukturą zdarzenia.