9 ms·

An Interactive Approach to API Prototyping Using OpenAPI

• florianmartens 2y ago
  That's really cool. We're on a similar path with https://api-fiddle.com 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?
  • bpedro 2y ago
    Your approach seems interesting because it removes some of the barriers to entry for non-technical people.
    • florianmartens 2y ago
      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.
      • florianmartens 2y ago
        I've bookmarked your blog and will follow along to see what kind of solution you come up with in the end :)