Blog | AsyncAPI Initiative for event-driven APIs

Communication

AsyncAPI Spec 2.5.0 Release Notes

The release of AsyncAPI 2.5 brings helpful additions, such as extended Server Variables reusability and many clarifications.

Vladimír Gorej

September 29, 2022·5 min read

Engineering

Event driven API documentation made simple (Client-Side Rendering).

A simple guide for programmers looking for instructions on how to generate documentation using their AsyncAPI files.

Michal Gornicki

September 28, 2022·5 min read

Engineering

Documenting SQS event-driven APIs with AsyncAPI

This post demonstrates how documenting event-driven architectures is possible, using SQS as a (real-world) example.

Governance for Asynchronous APIs: Announcing AsyncAPI & Spectral – Together!

The collaboration between Stoplight’s open-source linting tool, Spectral, and AsyncAPI will be a game-changer for creating more consistency in your API program. Check out what comes with the release of the AsyncAPI ruleset!

Jakub Rozek

May 25, 2022·6 min read

Communication

Summary of things that happened at AsyncAPI Initiative from January to April, 2022

New AsyncAPI brand. AsyncAPI 2.4 and work on the 3.0 spec release. Meetings organization change. 2022 conference organization. AND SO MUCH MORE!

Lukasz Gornicki

April 29, 2022·9 min read

Communication

AsyncAPI Spec 2.4.0 Release Notes

AsyncAPI 2.4 is now released. This brings really helpful additions, such as the new `messageId` field, Server Variables reusability, and security at Operation level

Sergio Moya

April 28, 2022·4 min read

Engineering

📑 Google Season of Docs 2022 at AsyncAPI

Check out the Docs project proposal we're submitting to GSoD 2022! You won't want to miss out.

Alejandra Quetzalli

March 25, 2022·9 min read

Community

Radical Transparency

There are multiple ways to manage an open-source project. At AsyncAPI, we chose the Open Governance model for many good reasons that Lukasz explained in his article Finding a Good Open Governance Mode

Fran Méndez

February 2, 2022·4 min read

Communication

AsyncAPI Spec 3.0 is coming!

Announcing the start of work on AsyncAPI Spec 3.0. Check out all the potential new features coming to AsyncAPI 3.0 and how you can get involved!

Harsh Mishra

March 10, 2022·3 min read

Communication

AsyncAPI at OpenForce

Two years ago, the AsyncAPI Initiative participated in Hacktoberfest to help folks start their journey in open source. Hacktoberfest was a very successful event. We got feedback that the level of comm

Lukasz Gornicki

March 1, 2022·3 min read

Communication

AsyncAPI Initiative 2021 in Numbers

AsyncAPI Initiative growth presented in different metrics from different channels in 2021.

Lukasz Gornicki

February 7, 2022·13 min read

Communication

AsyncAPI Spec 2.3.0 Release Notes

AsyncAPI 2.3 is now released. This brings enhancements allowing new ways of structuring AsyncAPI documents and support for describing Solace APIs.

Dale Lane

February 1, 2022·3 min read

Engineering

AsyncAPI and Apicurio for Asynchronous APIs

This post originally appeared on https://novatec-gmbh.de The OpenAPI specification has already established itself in many project and application areas. It can be applied to describe HTTP APIs in a

Nadja Hagen

January 26, 2022·11 min read

Communication

2nd half of 2021 at AsyncAPI

It has been a while since the last update on the things at AsyncAPI Initiative. Lots of things have happened since June. You better have a read or listen to the podcast.

Lukasz Gornicki

December 21, 2021·8 min read

Engineering

Change is coming to our AsyncAPI Developer Documentation

Did you know that you can contribute Docs to AsyncAPI as well? Code isn't the only way to contribute to OSS; Dev Docs are a huge help that benefit the entire OSS ecosystem.

Alejandra Quetzalli

December 13, 2021·7 min read

Engineering

Align Production Reality and Event Documentation with the AsyncAPI Discovery Tool

The idealized world of AsyncAPI is neat and tidy: Interface definitions show developers exactly what events are exchanged amongst producers and consumers. Event contracts only change when permitted b

Jesse Menning

December 7, 2021·4 min read

Engineering

The Reference Rabbit Hole

Sergio and I went down a bit of a rabbit hole the last couple of days while discussing Fran's proposal to solve the publish/subscribe confusion; I thought I would share the journey. A lot of this ca

Jonas Lagoni

November 30, 2021·11 min read

Engineering

The journey of documenting a Socket.IO API (Pt 2)

This post originally appeared on https://dedouss.is In the opening part of this series we outlined the basics of Socket.IO and discussed the importance of documenting Socket.IO APIs. Now it’s time

Dimitrios Dedoussis

November 4, 2021·14 min read

Communication

AsyncAPI Spec 2.2.0 Release Notes

2.2 release of AsyncAPI specification is here. The long-awaited feature for assigning channels to servers is finally here.

Lukasz Gornicki

September 28, 2021·3 min read

Engineering

The journey of documenting a Socket.IO API (Pt 1)

This post originally appeared on https://dedouss.is My recent adventures with Socket.IO took me off on a tangent, exploring the world of AsyncAPI as a means of documenting Socket.IO APIs. This is t

Dimitrios Dedoussis

September 23, 2021·7 min read

Communication

AsyncAPI Hackathon FAQ

Answers to all the questions you ever wanted to ask about the AsyncAPI Hackathon 2021

Lukasz Gornicki

September 19, 2021·5 min read

Engineering

AsyncAPI vs OpenAPI: Answers to Your Burning Questions About Two Leading API Specs

AsyncAPI and OpenAPI are different ways of defining application programming interfaces (APIs), also commonly known as API specs. Both API specs serve a crucial role in defining and governing distribut

Jesse Menning

September 8, 2021·7 min read

Communication

AsyncAPI Hackathon and Conference - Get Yourself Ready

It is official! October is an AsyncAPI Hacking Fest! and November 16-18 a 2nd online AsyncAPI Conference

Lukasz Gornicki

August 30, 2021·2 min read

Engineering

Using JSON Schema Beyond Validation

What is JSON Schema, why is it important and why is it so hard to use beyond validation? For those unfamiliar with Asyncapi we use a superset of JSON Schema as the default format for defining operat

Jonas Lagoni

August 3, 2021·7 min read

Communication

Mistake Odyssey

Experience with Git, GitHub, VS Code and Markdown for non-developers within AsyncAPI.

Barbaño González

July 15, 2021·5 min read

Communication

June 2021 at AsyncAPI

2.1.0 spec released, GSoC started, CLI released, other tools under heavy development. June was a hell of a ride.

Lukasz Gornicki

July 9, 2021·6 min read

Communication

AsyncAPI Spec 2.1.0 Release Notes

The eagle has landed! Check out all the changes the AsyncAPI specification introduces in the new v2.1.0 release

Lukasz Gornicki

June 29, 2021·4 min read

Communication

May 2021 at AsyncAPI

We have JSON Schemas for bindings and some great community tools, one that was donated to AsyncAPI Initiative

Lukasz Gornicki

June 22, 2021·4 min read

Engineering

Designing your APIs with AsyncAPI (Part 1)

How can you utilize code generation to speed up the development process and only focus on what is important - the business logic? In this miniseries, I will explore the ways AsyncAPI and code generati

Jonas Lagoni

June 1, 2021·10 min read

Engineering

AsyncAPI, CloudEvents, OpenTelemetry: Which Event-Driven Specs Should Your DevOps Include?

A decade ago, event-driven architecture was the wild west. Documentation? It’s in a spreadsheet somewhere. Where did the event go? Here’s a list of ten logs to search through. How do we make sure even

Jesse Menning

May 25, 2021·7 min read

Engineering

From API-First to Code Generation - A WebSocket Use Case

Learn how to go from API design to code generation. Create a WebSocket API for ChatBot. All supported by AsyncAPI

Lukasz Gornicki

May 19, 2021·20 min read

Communication

April 2021 at AsyncAPI

AsyncAPI 2.1 release is scheduled. Is there anything else that could be more important.

Lukasz Gornicki

May 14, 2021·6 min read

Engineering

Designing a unified Intent-driven API for all AsyncAPI's parsers

Afraid because of breaking changes? Learn how do we plan to reduce breaking changes in our tooling APIs by introducing a new design approach called Intent-driven.

Sergio Moya

May 7, 2021·13 min read

Engineering

Demystifying the Semantics of Publish and Subscribe

Learn how to interpret publish and subscribe operations when reading an AsyncAPI specification, and why they might not mean what you expect.

Nic Townsend

May 5, 2021·5 min read

Engineering

Creating AsyncAPI for WebSocket API - Step by Step

Learn how to create a complex AsyncAPI document using WebSocket API as an example.

Lukasz Gornicki

April 21, 2021·23 min read

Engineering

WebSocket, Shrek, and AsyncAPI - An Opinionated Intro

WebSocket is a protocol, an industry standard for building client applications that users love to use. What does AsyncAPI have to do with it?

Lukasz Gornicki

April 16, 2021·14 min read

Communication

March 2021 at AsyncAPI

AsyncAPI Initiative joined the Linux Foundation in March, but except of this, many other interesting things happened: new roadmap, google summer of code

Lukasz Gornicki

April 14, 2021·6 min read

Communication

AsyncAPI joins Linux Foundation

Today marks a delightful milestone for us at AsyncAPI: I'm proud to share with you that we're now a Linux Foundation project 🎉

Fran Méndez

March 30, 2021·2 min read

Engineering

Building an asynchronous flight notification service using AsyncAPI, MQTT, Amadeus and Twilio

Flight delays, cancelations and gate changes are among the most common headaches that travelers face. Now more so than ever, travelers need this information literally at hand to enjoy a stress-free tr

Alvaro Navarro

March 24, 2021·7 min read

Engineering

Understanding AsyncAPIs with a Practical Example

Learn how to map a real-world event-driven Microservices architecture into AsyncAPI specification

Dunith Dhanushka

March 18, 2021·10 min read

Communication

February 2021 at AsyncAPI

We are getting close to joining a foundation. We started a few new initiatives. We are busy. In other words, this is a good time to join us and drive things together.

Lukasz Gornicki

March 16, 2021·7 min read

Strategy

Finding a Good Open Governance Model for AsyncAPI

AsyncAPI can be successful if the initiative is community-driven. To be community-driven, we need the community to see it can drive things and make an impact. For that, we need a proper open governance model. What model would be the best?

Lukasz Gornicki & Fran Méndez

March 8, 2021·7 min read

Communication

January 2021 at AsyncAPI

I always thought January is a month of a slow start of a new year. I could not have been more wrong. No time to rest, no slow down here.

Lukasz Gornicki

February 11, 2021·8 min read

Engineering

Simplify code generation with React

React permanently changed the way how developers write web-apps. Personally, we love React and knew it would solve many pain points we faced with Nunjucks. Therefore in the last cycle we integrated it

Jonas Lagoni & Maciej Urbańczyk

January 25, 2021·8 min read

Engineering

How Microcks Can Speed-Up Your AsyncAPI Adoption - Part 2

On our first AsyncAPI blog post we have introduced Microcks 1.0 General Availability (GA) as a unique milestone for mocking and testing event-driven API like any other APIs through the support of Asyn

Laurent Broudoux

January 6, 2021·8 min read

Communication

Awesome 2020 and What Can Get Better In 2021

Fuck you COVID-19, AsyncAPI Community is stronger than you think. See the growth of AsyncAPI in 2020 in hard numbers. How we compare to 2019?

Lukasz Gornicki

December 23, 2020·18 min read

Communication

AsyncAPI partners with Postman to boost development of Asynchronous APIs

I'm proud and honored to let you know that we're partnering with Postman to boost the development of Asynchronous APIs to a new level.

Fran Méndez

December 8, 2020·3 min read

Communication

Happy Birthday AsyncAPI (week 47, 2020)

Happy Birthday AsyncAPI On 18.11.2017 Fran Mendez exclaimed "Eureka” and created AsyncAPI. The story is more complicated than that, but it is not a time for a history lesson, so let us keep it simple

Lukasz Gornicki

November 18, 2020·5 min read

Engineering

How Microcks Can Speed-Up Your AsyncAPI Adoption - Part 1

August 11th 2020 was the official announcement of Microcks 1.0.0 release and our first Microcks General Availability (GA) version to fully manage event-driven API through the support of AsyncAPI speci

Laurent Broudoux

November 11, 2020·3 min read

Community

Is Hacktoberfest Good For Maintainers?

tl;dr In October, we welcomed 26 new contributors with 70 pull requests (PRs) merged. It was an exhausting but also a fascinating experience. Hacktoberfest Is Ok Don't be afraid of Hacktoberfest. I

Lukasz Gornicki

November 5, 2020·9 min read

Communication

AsyncAPI Initiative Status Update (week 43, 2020)

AsyncAPI JavaScript Parser 1.0.0 Is Out I’m very proud to share that we are finally there, release 1.0.0 is out in the wild. One month passed since the last release candidate, and no one reported an

Lukasz Gornicki

October 21, 2020·4 min read

Communication

AsyncAPI Initiative Status Update (week 41, 2020)

New Website I'm super excited to share with you that last week we released a new AsyncAPI website: On a home page, we now promote Studio more and put much more emphasis on the different ways you can

Lukasz Gornicki

October 7, 2020·5 min read

Community

AsyncAPI @Hacktoberfest

<Warning title="HacktoberFest 2020 has finished" description={ Check out our summary blog post. There are lots of good insights! } /> What is AsyncAPI AsyncAPI is a specification for describing your

Lukasz Gornicki

September 30, 2020·5 min read

Communication

AsyncAPI Initiative Status Update (week 39, 2020)

Circular References Supported in HTML and Markdown Templates After recent efforts into circular references support in the AsyncAPI JavaScript Parser, now we started using these features in HTML and M

Lukasz Gornicki

September 22, 2020·4 min read

Communication

AsyncAPI Initiative Status Update (week 37, 2020)

We canceled the previous status update due to the vacation cucumber season, so this status update covers the last four and not two weeks. Please familiarize yourself with many things we worked on and

Lukasz Gornicki

September 9, 2020·4 min read

Communication

AsyncAPI Initiative Status Update (week 33, 2020)

Parser First Release Candidate is Alive Since the last update, we jumped from release 0.28.0 to 0.33.1. In the last two weeks we fixed a few bugs, in the parser and in the AsyncAPI JSON Schema that t

Lukasz Gornicki

August 12, 2020·3 min read

Communication

Avro Schema Parser and others in AsyncAPI Initiative Status Update (week 31, 2020)

Avro Schema Parser Short Intro to Schema Types in AsyncAPI There are many different schema formats that one might use to describe the message payload. Not everyone uses JSON Schema. There are multip

Lukasz Gornicki

July 30, 2020·5 min read

Communication

AsyncAPI Initiative Status Update (week 29, 2020)

Increasing the quality of tools with SonarCloud We enabled SonarCloud for the most critical AsyncAPI tools that are reaching or already reached 1.0.0 release. Luckily this amazing software is availab

Lukasz Gornicki

July 14, 2020·4 min read

Engineering

Event-Streaming: An Additional Architectural Style to Supplement API Design

This post originally appeared on Capital One Tech The growth and adoption of web-based APIs is key to the transformational technology journey of any enterprise. Those APIs, whether they are RESTful

James Higginbotham

July 7, 2020·6 min read

Communication

AsyncAPI Initiative Status Update (week 27, 2020)

AsyncAPI is innovation and you should assess it ThoughtWorks and InfoQ clearly point out this is the best moment to have a closer look at AsyncAPI specification. Specification brings standardization

Lukasz Gornicki

June 30, 2020·5 min read

Engineering

Choosing Between Web APIs and Message Streaming

When faced with a variety of options, how are developers building APIs supposed to know which is the right one for their solution? In this article, I’m going to outline the common characteristics for both REST APIs and message streaming so developers can better understand when (and when not) to use each one.

James Higginbotham

June 23, 2020·7 min read

Engineering

AsyncAPI Code Generation: Microservices Using Spring Cloud Stream

Code generation is no simple feat. There are a lot of complexities when it comes to generating useful application code. In this post, I am going to walk you through generating your own microservices u

Marc DiPasquale

June 2, 2020·12 min read

Engineering

API documentation in event-driven applications

We live in an era of distributed systems. Airlines and hotels communicate with each other to offer us a better experience in our travels; shops work with shipping companies, so we have our new product

Héctor Valls

May 18, 2020·4 min read

Engineering

(Part 2) Full automation of release with GitHub Actions and Conventional Commits for non-JS projects

This post and the previous one come from our experience we gained when working on full automation for all tools maintained by AsyncaPI Initiative.

Lukasz Gornicki

April 14, 2020·6 min read

Communication

AsyncAPI Online Conference scheduled for 22.04 11 AM UTC

It is happening, a first-ever AsyncAPI Online conference. We start on 22 of April, at 11 AM UTC. The event is going to take 7 hours with 12 talks from all over the world. We start in sunny Sydney and finish in cloudy Vancouver. The event is for free, online, in your favorite quarantine room.

Welcome to our blog!

AsyncAPI Spec 2.5.0 Release Notes

Event driven API documentation made simple (Client-Side Rendering).

Documenting SQS event-driven APIs with AsyncAPI

Governance for Asynchronous APIs: Announcing AsyncAPI & Spectral – Together!

Summary of things that happened at AsyncAPI Initiative from January to April, 2022

AsyncAPI Spec 2.4.0 Release Notes

📑 Google Season of Docs 2022 at AsyncAPI

Radical Transparency

AsyncAPI Spec 3.0 is coming!

AsyncAPI at OpenForce

AsyncAPI Initiative 2021 in Numbers

AsyncAPI Spec 2.3.0 Release Notes

AsyncAPI and Apicurio for Asynchronous APIs

2nd half of 2021 at AsyncAPI

Change is coming to our AsyncAPI Developer Documentation

Align Production Reality and Event Documentation with the AsyncAPI Discovery Tool

The Reference Rabbit Hole

The journey of documenting a Socket.IO API (Pt 2)

AsyncAPI Spec 2.2.0 Release Notes

The journey of documenting a Socket.IO API (Pt 1)

AsyncAPI Hackathon FAQ

AsyncAPI vs OpenAPI: Answers to Your Burning Questions About Two Leading API Specs

AsyncAPI Hackathon and Conference - Get Yourself Ready

Using JSON Schema Beyond Validation

Mistake Odyssey

June 2021 at AsyncAPI

AsyncAPI Spec 2.1.0 Release Notes

May 2021 at AsyncAPI

Designing your APIs with AsyncAPI (Part 1)

AsyncAPI, CloudEvents, OpenTelemetry: Which Event-Driven Specs Should Your DevOps Include?

From API-First to Code Generation - A WebSocket Use Case

April 2021 at AsyncAPI

Designing a unified Intent-driven API for all AsyncAPI's parsers

Demystifying the Semantics of Publish and Subscribe

Creating AsyncAPI for WebSocket API - Step by Step

WebSocket, Shrek, and AsyncAPI - An Opinionated Intro

March 2021 at AsyncAPI

AsyncAPI joins Linux Foundation

Building an asynchronous flight notification service using AsyncAPI, MQTT, Amadeus and Twilio

Understanding AsyncAPIs with a Practical Example

February 2021 at AsyncAPI

Finding a Good Open Governance Model for AsyncAPI

Lukasz Gornicki & Fran Méndez

January 2021 at AsyncAPI

Simplify code generation with React

Jonas Lagoni & Maciej Urbańczyk

How Microcks Can Speed-Up Your AsyncAPI Adoption - Part 2

Awesome 2020 and What Can Get Better In 2021

AsyncAPI partners with Postman to boost development of Asynchronous APIs

Happy Birthday AsyncAPI (week 47, 2020)

How Microcks Can Speed-Up Your AsyncAPI Adoption - Part 1

Is Hacktoberfest Good For Maintainers?

AsyncAPI Initiative Status Update (week 43, 2020)

AsyncAPI Initiative Status Update (week 41, 2020)

AsyncAPI @Hacktoberfest

AsyncAPI Initiative Status Update (week 39, 2020)

AsyncAPI Initiative Status Update (week 37, 2020)

AsyncAPI Initiative Status Update (week 33, 2020)

Avro Schema Parser and others in AsyncAPI Initiative Status Update (week 31, 2020)

AsyncAPI Initiative Status Update (week 29, 2020)

Event-Streaming: An Additional Architectural Style to Supplement API Design

AsyncAPI Initiative Status Update (week 27, 2020)

Choosing Between Web APIs and Message Streaming

AsyncAPI Code Generation: Microservices Using Spring Cloud Stream

API documentation in event-driven applications

(Part 2) Full automation of release with GitHub Actions and Conventional Commits for non-JS projects

AsyncAPI Online Conference scheduled for 22.04 11 AM UTC

Automate AsyncAPI workflows with GitHub Actions

Full automation of release to NPM and Docker Hub with GitHub Actions and Conventional Commits

Nunjucks templating explained on the basis of AsyncAPI specification

AsyncAPI 2.0.0 important dates

An API Strategist Explores Event-Driven APIs

AsyncAPI and CloudEvents

Status update (week 17, 2019)

Getting started with event-driven architectures

Status update (week 15, 2019)

Replicating the Success of REST in Event-Driven Architecture