An Interactive Approach to API Prototyping Using OpenAPI

apichangelog.substack.com

2 pointsbpedro4 comments

That's really cool. We're on a similar path with https://api-fiddle.com

We're trying to build the best tool out there for team that want to build api-first and speed up development and code generation this way.

I'm happy you wrote this article!

Here are a few questions for you: - Do you think the mock API is the best way to get Feedback from stakeholders? - How do you merge your changed OpenAPI document into your master documentation when it's time for prod? - How do you share your draft contract with e.g. a frontend engineer so they can get started building the UI?

Your approach seems interesting because it removes some of the barriers to entry for non-technical people.

Yeah, I think even if you are fairly technical it's still pretty hard to manage a growing OpenAPI doc that is good enough to generate clients, sdks and docs from it.

I think that we'll soon be able to help you generate mock clients as well. Probably by generating a first pass with AI and letting you adjust the details manually. This way it could be one-click.

I've bookmarked your blog and will follow along to see what kind of solution you come up with in the end :)

Reply on news.ycombinator.com