Designing APIs with Swagger and OpenAPI
by Joshua S. Ponelat and Lukas L. Rosenstock
Whilst I have quite a bit of experience working with gRPC based APIs, I’ve never touched
OpenAPI spec (formerly Swagger). In the age of LLMs, where having a FEATURE.MD at your
project root is common, I think strictly described APIs are more relevant than ever.
It’s a good intro book with a bit of inconsistent pacing, the authors can’t make up their minds if they’re writing for someone new to computers, so they teach the reader how to clear text from a textbox, or someone who’s interested in nuances of JSON Schema draft version differences.