What's the hardest OpenAPI spec you've ever worked with?
by•
Hi Product Hunt,
While building an OpenAPI SDK generator, I realized that real-world API specifications are often much messier than the examples we see in documentation. I'm curious—what's the biggest challenge you've encountered with OpenAPI? Circular references? Inconsistent naming? Missing schemas? I'd love to hear your experiences.
8 views
Replies
In my experience, the biggest challenge isn't complex schemas it's when the documentation and the actual API behavior slowly drift apart over time.
I think SDK generators are becoming just as important as the specs themselves. As APIs grow more complex, the quality of generated code can have a huge impact on the developer experience.