Что такое асинхронный API?

В отличие от синхронных API, использующих механизм обмена запросами и ответами, асинхронные API основаны на событиях. Это означает, что в случае применения асинхронных API приложению не требуется самостоятельно определять, когда можно запросить данные, поскольку приложение подписывается на поток событий и получает события по мере их появления.

Например, API заказов на основе HTTP может предоставлять доступ к операции 'GET' в каталоге '/orders'. Для проверки наличия новых заказов приложение, выполняющее роль клиента API, должно повторно отправлять запросы с путем '/orders'.

В случае асинхронного API приложение подписывается на поток событий заказов и принимает новые события заказов по мере их поступления.

Что такое AsyncAPI?

AsyncAPI - это спецификация, описывающая асинхронные API. Она аналогична спецификации OpenAPI, которая описывает синхронные API HTTP.

Основное отличие заключается в том, что OpenAPI описывает пути, а также запросы и ответы для операций, а AsyncAPI описывает каналы, содержащие события, и структуру событий.