logoalt Hacker News

RadiozRadiozyesterday at 6:08 PM2 repliesview on HN

Nice, I'll find this useful. I reference OpenAPI specs frequently as I practice spec-driven development. The spec is my source of truth for the interface, and I use it to generate both my client and server code. It automates all the request handling boilerplate on both sides, including validation, and provides me a typed interface regardless of which language I'm using. OpenAPI of course limits the types of endpoints you can create, but I find those limits stop you doing things that are strange/surprising. I find that creating APIs that can be expressed nicely in OpenAPI leads to APIs that have a consistent feel with few gotchas and a satisfyingly predictable developer experience.


Replies

thegagnetoday at 4:32 AM

What’s in your toolkit for server and client generation?

show 1 reply
der_gopheryesterday at 6:40 PM

100%, also openapi specs are usually huge yaml/json files and it's very hard to navigate them.