[APIdays Paris] AsyncAPI specification

A brief introduction to the AsyncAPI specification and how to define your message-driven systems.

Transcript

1. Photo by Drew Graham AsyncAPI specification
2. Fran Méndez A little bit about me Twitter @fmvilas Email fmvilas@gmail.com Photo by Eva Morcillo
3. BINGO TIME!
4. Show, don’t tell.
5. AsyncAPI What is it?
7. It is a specification With it you can describe: Event-driven microservices IoT APIs …and actually pretty much any system that is based on messages. Photo by Louis Smith Streaming APIs
8. It does NOT enforce any particular protocol However, it cares about the protocol because we think it’s an important information. AMQP MQTT WebSockets Kafka Photo by Axel Antas Bergkvist We’re exploring… Google PubSub CoAP NATS
9. It is NOT a library nor a software However, tooling is provided: Documentation generators Code generators What will you create next? Photo by Barn Images
10. AsyncAPI Why should you use it?
11. AsyncAPI could be a software but what really matters is the language, because it defines how we communicate. Language It’s a basic pilar of communication Photo by Gonard Fluit By defining a common language everybody can easily create interoperable tools, services or even products.
12. You can describe your APIs using both, JSON and YAML. Human/Machine It’s human and machine friendly. Humans can use GUIs for a more intuitive and accessible way of creating the AsyncAPI files. Photo by Alex Knight
13. API Lifecycle Take control of your API lifecycle. Photo by Boris Smokrovic Design Documentation Code Generation Testing API management Monitoring
14. Check out our repositories on Github: https://www.github.com/asyncapi Community-driven It’s open-source, it has always been open- source and it will always be open source. Photo by William White
15. AsyncAPI How to get started?
16. Photo by João Silas Tooling & Products editor.asyncapi.org Online Editor www.github.com/asyncapi Generators (code & docs)
17. Photo by João Silas Documentation & Help www.github.com/asyncapi/asyncapi Specification documentation www.asyncapi.org Website async-apis-slack.herokuapp.com Slack (auto-invite)
18. AsyncAPI is supported by And the list is growing!
19. Thank you. Twitter @fmvilas Email fmvilas@gmail.com www.asyncapi.org