I wanted to understand Swagger and the OpenAPI spec, so I wrote an OpenAPI spec for the Beeminder API. You can use this spec to auto-generate OpenAPI clients in any supported language.
Check it out on Github (.yaml, readme).
I hope this is useful for folks who might want to write wrappers around the API but don’t want to do the bootstrapping/boilerplate to set up an HTTP client from scratch in their language of choice.
I’m extra keen for tips on OpenAPI spec hygiene (specifically things like fields which I haven’t filled in but should for better doc generation, object naming conventions, etc.)
And please, @dreev, let me know if this isn’t kosher and I’ll take it down posthaste.