Documentation is an important way of communicating how your API works to its consumers. However, if yoe using OpenAPI (formerly known as Swagger) solely for documentation, you're openly tapping into a mere fraction of its power. Or, if you're not using OpenAPI at all, you're missing out on a huge way to reduce the workload involved in maintaining your API and enabling others to use it successfully. This talk will walk you through the development lifecycle of an API, from conception to consumption, and show you how an OpenAPI spec can be a boon to your project, be it new or legacy, at each development stage.

Comments

Comments are closed.

Jake Bennett at 11:32 on 17 May 2023

Great talk! Super helpful. Love it.

A great review of tooling and use cases to take OpenAPI well beyond the documentation use case. I will definitely be implementing the client generation tooling and testing the automatic validation tooling.

Really enjoyed the detail .

Preston Brink at 13:25 on 17 May 2023

Enjoyed this one. Lots of great resources.

Good talk covering OpenAPI and supporting tooling. I especially liked the screenshots, code examples, and introduction to tools to use with OpenAPI. Having used Swagger/OpenAPI for many years, I still learned new tips and tools I can go and try out. Talk went a little short, but with the content covered I left satisfied and didn't see a need to unnecessarily fill more time. Good work Matt!

john barclay at 17:09 on 18 May 2023

Very good coverage of breadth of benefits and tools fot open api. Went short ten minutes rsther than add filler or go down rabbit holes that could muddy the overview. Well done.