Reigniting the API Description Wars with TypeSpec and the Next Generation of API Languages
A talk given by Gareth Jones from Microsoft at the 2024 Austin API Summit in Austin, Texas.
Didn’t the API description wars end in 2017 when we all agreed that OAS was the way forward?
Yes, and yet how satisfied with your API descriptions are you? Are they thousands of lines of hard to read yaml or JSON? When someone makes a change, is it easy to review for correctness and completeness? Do visual tools make this easier? Do they support change management?
I’ll make the case that the next generation of more abstract DSLs for defining APIs such as Smithy from Amazon and TypeSpec, open sourced by Microsoft, move us back to a more intentional approach to design and give us the opportunity to highlight the business characteristics that matter most at design-time.
----------
Get the latest API insights straight to your inbox, subscribe to Nordic APIs newsletter: https://nordicapis.com/newsletter/
