R1D40 Swagger and OpenAPI
I first learned about Swagger when I started working at LaunchDarkly since our REST API follows the OpenAPI specification. This is such an amazing tool. I am sad that I did not learn about it before.
Swagger and OpenAPI allow you to create a spec for your REST API. You can then use some tooling in order to create clients in pretty much every language under the sun for your API.
It took me a few solid days to write a python wrapper for the CircleCI API. In the same amount of time, I could have theoretically written a swagger spec and made clients for all the languages.
I spent a few hours today looking through the documentation for Swagger and learning more about tooling. Why doesn’t every product use this?
Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.
Check out some more stuff to read down below.
Most popular posts this month
- SQLite DB Migrations with PRAGMA user_version
- Lev Lazinskiy
- Edge Detection with Inkscape
- Org Mode To Google Docs and Beyond
- Spring Security, Webjars, and MIME type error
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- Deeper dive: Were Touch Bar’s problems software rather than hardware? from Unsung
- Joining Cursor from Fatih Arslan
- Pluralistic: Digital sewer socialism (08 Aug 2026) from Pluralistic: Daily links from Cory Doctorow
- Pluralistic: Enshittification and Reverse Centaurs go global (29 Jul 2026) from Pluralistic: Daily links from Cory Doctorow
- AI Mania Is Eviscerating Global Decision-Making from Ludicity
- The default person from https://popagandhi.com/
- No-One Escapes the Permanent Underclass from Fernando Borretti
- Is it ethical to use AI? from charity.wtf
Articles from blogs I follow around the net
“They had no concept of a duty of care to their users.”
A Mastodon post by computer scientist David Chisnall has a very Unsung opener: I have used vim since around 2000. I have written five books, a PhD thesis, a few dozen papers and over 150 articles with it. At this point, my higher brain functions are not en...
via Unsung August 28, 2026You Know GDPR Is Good Based on Who Hates It
FDR has always been one of my favorite presidents, second maybe to Lincoln. Both were men the establishment assumed were one of them until, to their horror, they governed like they weren't. Both could trash the opposition in one breath and take the moral h...
via matduggan.com August 28, 2026The growing divide between AI hype and software engineering reality
It is widely accepted that there is an AI bubble in the financial markets at the moment. The moderate opinion is however that LLMs are constantly improving and will eventually take over more and more tasks from humans and increase productivity. But are LLM...
via Optimized by Otto August 28, 2026Generated by openring