Thomas Betts speaks with Fran Mendez, an expert in AsyncAPI V3, about the major goals and changes in version 3, including renaming 'Pavelast' and 'Subscribe' to 'Send' and 'Receive'. They also discuss getting started with Acing API and the introduction of Glee Framework, as well as the roadmap for future versions and the release of a new parser.
Async API v3 introduces 'send' and 'receive' verbs to clarify application actions.
Async API v3 supports request-reply interactions and improves user experience.
Deep dives
What is async API and its purpose?
Async API is a format and specification to define interactions between services or applications that exchange messages. It helps define the communication between different applications and the messages that are expected to be sent and received. Async API is not just a specification but also provides a set of tooling for contract testing, documentation generation, runtime validation, and infrastructure as code.
Difference between async API and Open API
Async API originated from Open API (formerly known as Swagger) and is specifically designed for asynchronous processing and event-driven architectures. While Open API is used to specify contracts for APIs and is focused on request-response patterns, async API tackles the challenges of async and event-driven interactions. It allows you to define what an application is doing, such as sending and receiving messages, and enables the modeling of different communication patterns in a protocol-agnostic manner.
New features and improvements in version 3 of async API
Version 3 of async API was developed to address confusion around the 'publish' and 'subscribe' verbs in version 2. The new version introduces the 'send' and 'receive' verbs, which clarify the perspective of the document and define what an application is doing. Additionally, async API version 3 brings support for request-reply interactions, enabling the specification of various request-reply patterns specific to event-driven architectures. The release of version 3 also focused on providing valuable features to users and improving the user experience.
When to migrate to async API version 3
Migration to async API version 3 is recommended if you need features like request-reply support or if maintaining version 2 becomes challenging due to issues with 'publish' and 'subscribe'. However, if version 2 is sufficient for your needs and you're comfortable with it, there is no immediate need to migrate. Version 2 will continue to be supported. To facilitate the migration process, async API provides tools like the async API parser, generator, CLI, and the async API studio. These tools can assist in converting version 2 documents to version 3 quickly and efficiently.
In this episode of the podcast, Thomas Betts speaks with Fran Mendez about version 3 of AsyncAPI. The standard format for describing asynchronous APIs has evolved, and has made some breaking changes to address limitations in earlier versions.
Read a transcript of this interview: https://bit.ly/3GMLtCv
Subscribe to the Software Architects’ Newsletter [monthly]: www.infoq.com/software-architect…mpaign=architectnl
Upcoming Events:
QCon London
qconlondon.com/
April 8-10, 2024
Follow InfoQ:
- Mastodon: https://techhub.social/@infoq
- Twitter: twitter.com/InfoQ
- LinkedIn: www.linkedin.com/company/infoq
- Facebook: bit.ly/2jmlyG8
- Instagram: @infoqdotcom
- Youtube: www.youtube.com/infoq
Write for InfoQ
- Join a community of experts.
- Increase your visibility.
- Grow your career.
www.infoq.com/write-for-infoq/?u…aign=writeforinfoq
Get the Snipd podcast app
Unlock the knowledge in podcasts with the podcast player of the future.
AI-powered podcast player
Listen to all your favourite podcasts with AI-powered features
Discover highlights
Listen to the best highlights from the podcasts you love and dive into the full episode
Save any moment
Hear something you like? Tap your headphones to save it with AI-generated key takeaways
Share & Export
Send highlights to Twitter, WhatsApp or export them to Notion, Readwise & more
AI-powered podcast player
Listen to all your favourite podcasts with AI-powered features
Discover highlights
Listen to the best highlights from the podcasts you love and dive into the full episode