INTERFACE, by apidays - APIs: the next 10 years June 8, 9 & 10 2022 The power of AsyncAPI - tools-side capabilities Maciej Urbańczyk, Senior Frontend Engineer at Postman ------------ Check out our conferences at https://www.apidays.global/ Do you want to sponsor or talk at one of our conferences? https://apidays.typeform.com/to/ILJeAaV8 Learn more on APIscene, the global media made by the community for the community: https://www.apiscene.io Explore the API ecosystem with the API Landscape: https://apilandscape.apiscene.io/ Deep dive into the API industry with our reports: https://www.apidays.global/industry-reports/ Subscribe to our global newsletter: https://apidays.typeform.com/to/i1MPEW

1. Building the future of
event-driven architectures.

2. 2022 SERIES OF EVENTS
New York
JULY
(HYBRID)
Australia
SEPTEMBER
(HYBRID)
Singapore
APRIL
(VIRTUAL)
Helsinki & North
MARCH
(VIRTUAL)
Paris
DECEMBER
(HYBRID)
London
OCTOBER
(HYBRID)
Hong Kong
AUGUST
(VIRTUAL)
JUNE (VIRTUAL)
India
MAY
(VIRTUAL)
APRIL (VIRTUAL)
Dubai & Middle East
JUNE
(VIRTUAL)
Check out our API Conferences
www.a pida ys .globa l
Want to talk at one of our conferences?
apidays.typeform.com/to/ILJeAaV8

3. Maciej Urbańczyk
Senior Frontend Engineer
Postman
https://github.com/magicmatatjahu
https://www.linkedin.com/in/maciej-urba%C5%84czyk-909547164/

4. THE POWER OF ASYNCAPI
TOOLS-SIDE CAPABILITIES

5. 4
ASYNCAPI IS AN INTERFACE
FOR DESCRIBED APPLICATION

6. 5
TOOLING IN THE
ASYNCAPI ECOSYSTEM

7. 6
SPEC-ORIENTED
TOOLS
ParserJS
ParserGO
Converter
Optimizer
Diff
Bundler “
Every tool (except
parsers) needs a valid
AsyncAPI document.

8. 7
CAPABILITY-ORIENTED
TOOLS
Generator
Cupid
Glee
“
Every tool (except
parsers) needs a valid
AsyncAPI document.
Modelina

9. 8
IDEAS

10. 9
GENERATE CODE/DOCS
BASED ON ASYNCAPI DOCUMENT
Documentation
API Client
Models
Server Boilerplate

11. 10
THE
GENERATOR
Generate code/docs based on your AsyncAPI document
VALID ASYNCAPI
GENERATOR
API CLIENT
DOCUMENTATION
MODELS
SERVER BOILERPLATE
TEMPLATE
https://github.com/asyncapi/generator

12. 11
THE
GENERATOR
Available templates
DOCUMENTATION
GENERATOR
API CLIENT SERVER BOILERPLATE
TypeScript NATS client
.NET C# NATS client
CUSTOM
TEMPLATE
GO client using Watermill
HTML documentation page
Markdown documentation
PDF documentation
NodeJS Server - Generic and
only for WebSocket protocol
Java Service - JMS, Spring,
Spring Cloud Stream
Python service that uses Paho
library
…
…
…
https://github.com/asyncapi/generator

13. 12
GENERATE
CODE/DOCS
How to generate?
Generate by the CLI
Generate by the Studio
Generate by the ServerAPI
https://github.com/asyncapi/generator
Use Github Action

14. 13
THE
MODELINA
Generate models from schemas
https://github.com/asyncapi/modelina
MODELINA

15. 14
FIND & ANALYZE THE RELATIONSHIP
BETWEEN ASYNCAPI DOCUMENTS
Finding data flow (messages) between
apps based on channels & operations
Describing relationships in larger systems -
brokers
Remember about Publish/Subscribe meaning

16. 15
HOW TO FIND
RELATIONSHIP
Based on https://github.com/amadeus4dev/amadeus-async-flight-status
Server
Subscriber Service
Notifier Service
Monitor Service
Relationship

17. 16
THE
CUPID
Find and analyze the relationships between AsyncAPI documents
VALID FIRST ASYNCAPI
VALID SECOND ASYNCAPI
VALID N-TH ASYNCAPI
CUPID
https://github.com/asyncapi/cupid

18. 17
SPEC AS A CONFIG

19. 18
THE
GLEE
The AsyncAPI framework that will make
you smile again (hopefully) :)
It makes sure your code and
AsyncAPI definition are on par. No
more outdated documentation.
Glee takes care of it for you,
automatically.
GLEE
Running
application
Wrong
implemented
operations
https://github.com/asyncapi/glee

20. 19
THE
GLEE
How it works?

21. 20
AT THE END
The presented ideas of using AsyncAPI are not the only possibilities
Please remember that mentioned tools may not support certain use cases
Without the community this presentation would not have happened

22. 21
THE
INITIATIVE
Join us!
twitter.com/AsyncAPISpec
asyncapi.com/slack-invite
www.asyncapi.com
linkedin.com/company/asyncapi
github.com/asyncapi

23. THANKS FOR ATTENTION!