• Skip to primary navigation
  • Skip to content
  • Skip to primary sidebar
  • Skip to footer

Fran Méndez

Personal website

  • Home
  • AsyncAPI
  • Blog
  • About
  • Contact

AsyncAPI 1.2.0 is out now!

AsyncAPI specification · April 15, 2018

As promised, we’re doing smaller and more frequent releases. So, it’s time for AsyncAPI 1.2.0! This version adds support for exciting new features, such as a way to document Streaming APIs and Event-based APIs, i.e., those that don’t have topics, e.g., the WebSockets ones.

Let’s go through all the new features of this release:

Streaming APIs and Event-based APIs

I’m very proud to announce the release of these features. Streaming API support, so far, goes for HTTP 1.1 chunked encoding and HTTP 2 server-sent events (SSE).

On the other hand, we have event-based APIs, e.g., WebSockets APIs. It solves the problem for those who implement APIs not using topics at all.

As an example, check the Gitter streaming API and Slack Real-Time Messaging API. Also, Kin Lane, the API evangelist, will be documenting lots of these APIs for the Streamdata.io catalog, so make sure you also follow him.

Avoiding parameters duplication

In the last release, we added support for topic parameters, however, if the same parameter was present in multiple topics, you had to duplicate the definition. That’s not ideal, so Mike Ralphson added support for components/parameters, where you can place the common definitions. Check out this example.

What’s next?

In the next release, we’ll be targeting two new features: message content-type and custom topic separators. Do you want me to notify you whenever there’s a new AsyncAPI release? Subscribe using the following form:


Until next time! 👋

Filed Under: AsyncAPI specification Tagged With: AsyncAPI

Fran Méndez

APIs & Integrations Engineer at New Relic. Former Lead Engineer at Hitch. Creator of the AsyncAPI specification.

« Docgen now supports AsyncAPI 1.1.0 (and more!)
Thoughts on the Atlassian App Week 2018 (Portland) »

Reader Interactions

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Primary Sidebar

Newsletter

Recent Posts

  • Thoughts on the Atlassian App Week 2018 (Portland)
  • AsyncAPI 1.2.0 is out now!
  • Docgen now supports AsyncAPI 1.1.0 (and more!)
  • Announcing AsyncAPI 1.1.0
  • Nordic APIs Tooling Review: AsyncAPI

Newsletter

Footer

  • Github
  • Linkedin
  • Twitter

Copyright © 2021 · Fran Méndez