r/OpenAPI • • May 19 '25

How to Understand Open API in depth

0 Upvotes

r/OpenAPI • • Dec 05 '21

Tutorial - How to monetize your APIs

0 Upvotes

Hi,

here's a comprehensive guide on how to monetize your APIs

you can use your OpenAPI specification file to shorten the process, in a few minutes your can start selling your API!

https://www.reddit.com/r/api/comments/r9i7av/tutorial_how_to_monetize_your_api/

good luck!!!


r/OpenAPI • • Dec 20 '22

Enrich your OpenAPI spec with response examples easily

Thumbnail
github.com
0 Upvotes

r/OpenAPI • • Apr 29 '25

Documenting Spring boot API-REST with Swagger and Open API

0 Upvotes

Learn how to document your spring boot api rest with open-api and swagger.

https://juanespinozaweb.wordpress.com/2024/07/21/springboot-api-rest-swagger


r/OpenAPI • • Mar 10 '23

I created an article about how to protect the swagger using AWS cognito.

Thumbnail
noiselesstech.net
0 Upvotes

r/OpenAPI • • Apr 03 '24

Using OpenAPI to generate SDKs for public APIs

Thumbnail
konfigthis.com
0 Upvotes

r/OpenAPI • • Oct 30 '22

openapi-yup-generator: CLI tool for generating yup definitions from openapi3.yaml

0 Upvotes

r/OpenAPI • • Jul 21 '22

But The Postman Rang Only ONCE!

Thumbnail
medium.com
0 Upvotes

r/OpenAPI • • Oct 03 '23

Awesome Postman and Insomnia alternatives

0 Upvotes

Hey folks, in spite of recent events we have compiled a list of free, open-source and awesome alternatives to Postman and Insomnia.

Here's the link: https://github.com/stepci/awesome-api-clients
Could you please give it a star, so more people can see it?

Would love to hear if you have more suggestions!


r/OpenAPI • • Mar 16 '26

Claude +docs --> OpenAPI spec

1 Upvotes

I recently came across an API and needed its OAS file, the documentation did not have any downloadable links and hacks didn't work as well. I gave the documentation link to Claude and asked it to create OAS file for me, the first pass had multiple issues related to syntax and linting, I tested it with swagger editor and shared the feedback. It worked on it and gave me the correct OAS file, took me 10 minutes.

Wondering are there any tools that can give me correct OAS files from docs.


r/OpenAPI • • Sep 24 '23

Why are AI tools important in recent times?

1 Upvotes

r/OpenAPI • • Jul 31 '21

sqlite?

1 Upvotes

Does openapi work with sqlite? I can't find anything about using swagger with sqlite.


r/OpenAPI • • Mar 31 '25

Prototyping OpenAPI docs with LLMs

Thumbnail
zuplo.link
2 Upvotes

r/OpenAPI • • Aug 19 '24

im so confused

2 Upvotes

Hi im trying to get into openapi, but its all so confusing and i cant seem to find a proper guide to all of it. Is there anyone that knows any resources or is willing to help?


r/OpenAPI • • Jul 18 '24

How to create bot

2 Upvotes

Hello, I want to register on sites to obtain a visa, but the site closes in 3 minutes. I can barely fill out my information. I think there are those who use bots to help them register, and they sell the interview date at high prices. Can someone tell me how to get this type of bot


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 • • May 31 '25

Built a visual OpenAPI YAML editor to scratch my own itch — looking for feedback

3 Upvotes

Hello all,

So I’ve been working a lot with OpenAPI specs lately — mostly juggling YAML manually in VSCode or Swagger Editor — and it was slowly driving me mad.

Even small changes would break something upstream, and I’d spend half my time just debugging indentation or figuring out $ref nesting issues. Add LLM-specific extensions or function-calling formats, and it becomes a tangle real quick.

So, I ended up building something for myself:
👉 yamlstudio.com — a drag-and-drop, form-based OpenAPI YAML generator.

It’s totally free and still very much in progress, but I wanted:

  • A visual builder to define paths, methods, schemas, etc.

  • Support for custom extensions like x-* fields

  • Cleaner mental model than flipping between YAML blocks

Not trying to pitch — just figured this community might have some folks who’ve faced the same pain. If you do check it out, I’d genuinely love your thoughts (what’s missing, what sucks, what works).

Thanks 🙌


r/OpenAPI • • Apr 29 '25

Generate Web Service Client with open-api tools

2 Upvotes

Hi, I'd like to share my latest post on my personal blog, I talked about how to generate a Web service client with Java based on an open-api definition with open-api tools.

https://juanespinozaweb.wordpress.com/2025/04/19/generate-web-service-client-with-open-api-tools/


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 • • Apr 07 '25

API Workflows and How to Define Them

Thumbnail
zuplo.com
5 Upvotes

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 • • 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!


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 • • Apr 10 '25

Video: Gemini 2.5 Pro OpenAPI Generation Skills!

Thumbnail
zuplo.link
2 Upvotes

A quick look at how well Gemini 2.5 Pro can generate OpenAPI documents without a lot of specificity in the prompt. Check out the scores in the video but needless to say it's a solid partner for your initial document creation.