r/OpenAPI • • May 27 '25

Why is writing OpenAPI YAML still such a pain in 2025?

11 Upvotes

Hello Guys,

Okay, real talk — why does writing OpenAPI spec still feel like I’m playing Jenga with a blindfold?

It’s 2025. We have LLMs writing poems, generating code, simulating personalities... but somehow I still spend hours fiddling with indentation, double-checking schemas, and wondering why requestBody isn't working the way I expect it to.

Even with Swagger Editor or VSCode plugins, the feedback loop is slow and clunky. You make a change, preview it, realize you broke something upstream, go back, fix, test again. And god forbid you want to define something dynamic or deal with complex nested schemas — suddenly you're knee-deep in components/schemas/ThingThatInheritsFromOtherThing.

It gets worse when you’re:

  • Trying to make it LLM-friendly (for function calling or agents)

  • Wrangling 20+ endpoints in a microservices setup

  • Onboarding new devs to maintain this monster spec

Half the time I end up writing my own custom scripts just to auto-generate the damn thing from JSON or scratch notes.

Just curious — how do you all deal with this?
Are you still hand-writing these specs? Using generators? Some custom hack?
Is this just our dev rite of passage now?

Would love to hear horror stories or shortcuts people are using, especially if you’re trying to keep your OpenAPI spec actually maintainable. 😅

Edit 1;


r/OpenAPI • • Sep 21 '24

Analyzing the OpenAPI Tooling Ecosystem

Thumbnail
modern-json-schema.com
9 Upvotes

r/OpenAPI • • Mar 07 '24

Generate OpenAPI spec from documentation links with LLM (open-source)

8 Upvotes

hey! a friend and I have been working on proof of concept to generate OpenAPI specification from documentation links. here's how it works:

then run it! the tool will then scrape, clean and generate the OpenAPI with LLMs. take it for a spin and give some feedback!

here's the repo: https://github.com/skyffel/airbyte-connector-generator-poc


r/OpenAPI • • Oct 27 '25

OpenAPI Editor Recommendations

7 Upvotes

looking for recommendations for a desktop app for MacOS to design OpenAPI Schemas.

I used to use stoplight, and so far everything I found is online only.


r/OpenAPI • • Oct 03 '25

OpenAPI / JSON learning resource

7 Upvotes

Hello!

Last month I did research from the community about existing use of learning resources for both OpenAPI & JSON schema specifications. We had a hunch there could be an improvement, in a unified and interlinked experience for junior - senior devs to both learn and revise.

Check it out here: appear.sh/api-toolkit/specs

I published it last night and hope to gather feedback and issue reports from anyone interested.

Features:

  • OAS + JSON are interlinked within the page for most URLs, meaning less off-site links and switching tabs

  • Hidden boilerplate to reduce clutter

  • Added code examples in specs section to add context

  • Supports all OAS versions and JSON docs, inc. OAS 3.2

  • Added resource pages for further reading (FAQs, Glossary, Misunderstood keywords) for newcomers to OAS/JSON

  • AI chat using specs and diffs for deterministic responses with reference anchor links for further reading

  • Highlightable text to add your own notes, stored locally

  • OpenAPI tools list: searchable, filterable, showing popularity and maintenance of repo

I hope it provides a smoother learning experience!

Cheers,

Tom


r/OpenAPI • • Aug 20 '25

OpenAPI spec / JSON schema spec resources

7 Upvotes

Hey all,

What do you all use as references / sources for the OpenAPI and JSON schema specs?

I am wondering if you frequently/infrequently use internal resources, dev tools, or just websites for this purpose, i.e. referencing, learning, etc etc.

I'm toying with an idea and doing some research.

Cheers!

Tom


r/OpenAPI • • Aug 12 '24

Folks using OpenAPI - What do your stacks look like?

6 Upvotes

I am new to OpenAPI- but have experience building Rest APIs. I am curious - What tech stack/architecture are you using and where does OpenAPI fit in.


r/OpenAPI • • Jul 13 '24

Help Me Improve API Test Coverage Tools for My Bachelor Thesis!

6 Upvotes

Hey everyone,

I’m conducting research for my bachelor thesis and need your insights on API test coverage. Your feedback will help build better tools for developers like you.

What is API Test Coverage?
API test coverage shows how well the different parts of an API are tested. It focuses on making sure all possible requests and responses work as expected. This is different from regular test coverage, which checks how much of the source code is tested. Both are related because they ensure the overall quality and reliability of the software.

Why This Matters:
Good API test coverage means fewer bugs and a better user experience. By understanding your needs and challenges, I can help create tools that make testing easier and more effective.

How You Can Help:
I have a short survey that asks about your experience with API test coverage and what features you’d like in new tools. It will only take a minute or two to complete.

https://forms.gle/NFNV3LrapKocKKvR9

Thank you very much for your time and input!


r/OpenAPI • • Aug 07 '23

Survey for bachelor thesis

6 Upvotes

Hello there, I'm Tillman a computer science student at Albert-Ludwigs-Universität Freiburg, where I currently work on my bachelorthesis with the @galaxyproject.

I am conducting a survey as a part of my thesis, where I try to evaluate developer experience in the context of using OpenAPI. After taking a look at the benefits provided by the specification and related tools, I will compare automatically generated and handcrafted language bindings, to gain a deeper understanding.

The evaluation criteria are how developers feel about their work, how they perceive the value of their contribution and how they view the development infrastructure.

I would really appreciate it, if you could take 5 minutes to takes the survey :)

https://forms.gle/RDT5ieZAYYuSFMEDA


r/OpenAPI • • Dec 06 '22

Language-Idiomatic SDK Generator for OpenAPI

6 Upvotes

Hi all,

I work at Speakeasy and we just released our CLI publicly. It generates language-idiomatic SDKs from OpenAPI specs; current support for: Go, TS, Python, Java (alpha).

We developed/tested the generator against the public openAPI directory, and feel like the libraries it builds are a major improvement on the existing SDK gen tools available. Specifically, we feel the experience for the developers using the libraries is a big improvement.

If anyone has any feedback or questions don't hesitate to reach out or join our slack for support. Cheers!


r/OpenAPI • • Apr 07 '25

API Workflows and How to Define Them

Thumbnail
zuplo.com
5 Upvotes

r/OpenAPI • • Apr 01 '25

Automating OpenAPI Generation using Network Traffic

Thumbnail
zuplo.com
5 Upvotes

r/OpenAPI • • Sep 18 '24

Generate Wasm bindings using OpenAPI-format schemas

Thumbnail
extism.org
5 Upvotes

r/OpenAPI • • Sep 07 '24

OpenAPI-First Dreamers Wanted: Join Me in Building Free Tools

5 Upvotes

Hey OpenAPI community,

I’ve been working in API strategy and middleware(SOA) for 14 years now, mostly in the financial sector, helping build and manage multi-provider and multi-tenant installations. Over time, I noticed the same challenges popping up for people wanting to adopt an OpenAPI-first approach and that’s why I’ve developed a free tool to make designing and managing APIs easier.

This is more than just a tool – it's a passion project aimed at uniting those of us who believe in the API-first approach. I want to create a space where we can share experiences, feedback, and ideas to improve how we build and manage APIs.

If you’re someone who shares that belief and wants to be part of this journey, join me! Let’s build something amazing together.

I’d love to hear what you think. Your insights will help shape the future of this project.

Thank you for being part of the API-first movement! GST-hub


r/OpenAPI • • May 05 '24

RAWG API

5 Upvotes

Hi!

Does anybody have the RAWG API data? The API has been shut down and I was using it for my final project. This puts me in a lot of problems and I am hoping that someone has that data. Has anybody scraped that DATA?? Thank you in advance!!!


r/OpenAPI • • Sep 01 '23

Full OpenAPI Track at APIDays London (Sept 13-14)

5 Upvotes

Coming up soon! Sept 13-14, 2023, is APIDays London. If you would like to learn more about the APIDays events, please watch Erik Wilde from OpenAPI and Mehdi Medjaoui, founder of API Days, talking about "Getting the OpenAPI Community Together: OAI Track at API Days"

https://www.youtube.com/watch?v=3ZIT-8w4twk


r/OpenAPI • • Jun 27 '22

What 's your preferred visual API editor ?

5 Upvotes

Headline pretty much sums it up: if you don't write down the whole yaml definition by yourself: what's your favorite GUI-based editor?

Free to use editors would be preferred for now but if someone can point out a solution that gives the biggest bang for your buck then these hints are welcome as well.

So far I've tried:

In all cases the online version was used.

To the hardcore code enthusiasts: yes, coding in the editor gives you exactly what you need if you know what you want (and how to define it) but I'd still prefer learning all about the definitions and best practices while not having to write it all down myself. One can be smart AND lazy. ;-)

Thanks in advance, any help is appreciated!


r/OpenAPI • • Jul 17 '20

A guide to OpenAPI and how to use it

5 Upvotes

r/OpenAPI • • Nov 10 '25

Open API - Advice Required

4 Upvotes

Hi,

I have Oauth2 access to an api database that we need to use for our work.

I created an azure web app in next.js & handsontable to fetch and write data to and from the api which works fine but as my requirements are growing the development with continued local development and then git re-deploys to azure can be slow and frustrating just to change maybe a couple of cells.

I could probably build exactly what i need in excel with an access token but need to be able to give a few other remote colleagues access to the app with their own outh2 access.

I just want to load the json responses into a structured table, e.g client name, address, contact details, dependants, some financial data and other details with placeholders for any missing data and then edit or add the data and send back. I also need to then open each financial account linked to client and tasks related to the client. Each will open in a standardised table format.

There is also some data i need to create, read and write alongside the api that I'm storing in an azure blob as the api is missing some fields we require.

I'm fairly new to this so any pointers or suggestions of an easier way to do this would be greatly appreciated. Needs to be UK GDPR compliant.

Thank you


r/OpenAPI • • Sep 21 '25

AI-Powered OpenAPI Playground

4 Upvotes

Playground (no sign-up needed): https://playground.swytchcode.ai/
Create your own project: https://app.swytchcode.com

Hey everyone,

I've built Swytchcode, an AI-driven tool that turns your OpenAPI specs into a fully interactive playground in seconds.

What you can do:

  • Upload & Host: Drop in any OpenAPI YAML/JSON and instantly share a live, interactive spec.

  • Generate Code & Workflows: Auto-create multi-step API workflows and client code snippets in many languages.

  • MCP Integration: Let developers query methods and workflows directly through Model Context Protocol.

  • Analytics: See what endpoints and parameters developers explore the most to guide your API roadmap.

  • AI Assistance: Suggest example calls, validate responses, and highlight potential improvements.

I'd love feedback from folks who work with OpenAPI every day:

  • Which of these features would actually save you time?

  • Is there any feature that your team would find indispensable?

No sign-up needed to try the demo (there’s a sample Stripe spec), but you can create a free account if you want to upload your own.

Would love to hear your thoughts and suggestions!


r/OpenAPI • • Sep 08 '25

Generating API Gateway Terraform from OpenAPI specs - useful or overkill?

4 Upvotes

Working on a tool that converts OpenAPI/Swagger specs into Terraform for AWS API Gateway. The idea is to eliminate repetitive infrastructure code when deploying multiple APIs.

Input: OpenAPI spec with optional x-rate-limit extensions Output: Complete Terraform project with API Gateway v2, routes, throttling

./striche.sh generate -s api-spec.yaml -p aws
# Creates modules/, main.tf, variables.tf, etc.

The generated Terraform is standard code you could write manually - no abstractions or custom providers.

Useful for teams with lots of microservices, or overkill?

Link: https://github.com/striche-AI/striche-gateway

Looking for feedback from folks who work with API Gateway infrastructure regularly.


r/OpenAPI • • Aug 05 '25

Just dropped a JetBrains plugin for Arazzo spec – feedback welcome! 🚀

4 Upvotes

Hey OpenAPI folks! 👋

I’ve just released the initial version of a JetBrains plugin for the Arazzo Specification — a new initiative under the OpenAPI umbrella focused on describing async workflows.

This plugin brings basic Arazzo support to JetBrains IDEs like IntelliJ IDEA, WebStorm, and others.

✅ What’s working:

  • File recognition

  • Context-aware autocompletion (based on schema)

🔜 Coming soon:

  • Real-time validation + inspection

👉 https://plugins.jetbrains.com/plugin/28079-arazzo

If you’re experimenting with Arazzo or contributing to the spec — I’d love your feedback!

Also open to ideas, issues, and PRs


r/OpenAPI • • Jul 29 '25

OpenAPI Specs for AI Integrations

4 Upvotes

Just wanted to point you to a blog post where we explain why we implemented AI Integrations using OpenAPI standard and not MCP, for those interested you can find it at https://bionic-gpt.com/blog/integrations/

I've also created a short video showing how we use this in our app

https://youtu.be/W04E5JWH8_8


r/OpenAPI • • Jul 26 '25

OpenAPI YAML to Code

4 Upvotes

Hey guys, I was just wondering how to actually convert an OpenAPI YAML Configuration into code, not just directly creating the API but for a variety of use cases, for example, creating an MCP Server tool from the OpenAPI configuration.
Is it generally used in tech companies, and if yes then what kind of tools do they use to convert the configuration to code?
Thanks.


r/OpenAPI • • Jun 03 '25

Automatically test all endpoints, ideally using existing Swagger/OpenAPI spec

4 Upvotes

I'm looking for a tool that can connect to my Swagger, automatically generate and test different inputs (valid + invalid) and report unexpected responses or failures (or at least send info to appinsights).

I've heard of Schemathesis, has anyone used that? Any reccommendations are welcome!