My Experiences with the OpenAPI Generator
The OpenAPI Generator is amazing in concept, but is a terrible experience in reality.
A place to share my knowledge about OpenAPI and how best to use (and abuse) it.
Inside OpenAPI
Generate your OpenAPI specifications from server side frameworks like FastAPI, Flask, etc...
Generate comprehensive API documentation using OpenAPI with platforms like Mintlify, Scalar, Docusaurus, etc...
Generate SDKs for your API with platforms like Speakeasy, etc...
Test your API contracts with platforms like Pact, TestContainers, etc...
OpenAPI centric content
The OpenAPI Generator is amazing in concept, but is a terrible experience in reality.
Take any API, document that API in enough detail, and the OpenAPI specification will sprawl.
I've had the absolute privilege of working on dozens of OpenAPI Specs and I'm excited to share my thoughts and experiences with you all through this blog.
Updated at: 9/27/2024, 12:09:15 PM