search

mxp100 / insomnia-plugin-openapi-export

Insomnia export to OpenAPI / Swagger
MIT License
7 stars 2 forks source link

How to use #1

Closed DavidSint closed 1 year ago

DavidSint commented 1 year ago

Hi Yuriy,

I was looking at your plugin, but with my very limited experience with Insomnia Plugins, I couldn't actually work out how to use it to export an API 😅

So, once this plugin is installed, how do you use it to an export an OpenAPI spec?

mxp100 commented 1 year ago

ok, i add to readme short instructions in this week. Using very simple -> choose you collection and in submenu (where built in export/import collection) "Export as OpenAPI 3.0", after several seconds select you base URL environment (using in you collection) or skip (if not needed). Required 1 base URL using for OpenAPI servers section. P.S. Sorry for my english ;)

DavidSint commented 1 year ago

No problem, when I try to follow the instructions, I only see three export options: Insomnia v4 (JSON), Insomnia v4 (YAML), and HAR - HTTP Archive Format :(

Not sure what I'm doing wrong as I have the plugin enabled in settings and I have refreshed the app.

mxp100 commented 1 year ago

Export in collection option popup. Insomnia plugin system can't support add new export plugins to built-in exports. image

jovial-snyder commented 1 year ago

hey @mxp100 great plugin, thank you. I was also confused how to use it until i saw your screenshot. I would recommend updating the README with a section that explains how to use this plugin.