Swagger Editor

[an7...@gmail.com]

Hi, 

I want to start document my REST API in Swagger.

Following swagger web site, I started doing so with the Swagger-Editor.

Currently I am editing on the Web, and I see that I have an option to upload/download *.yaml files.

Yet, I wanted to make sure that this is the right approach for editing? Is this the tool I should use or there are others? Is the Web-Editor maintained and aligned with the latest swagger specification?

I have encountered a problem that from a search in the web, was reported in the past and declared as resolved, so I am suspecting that I maybe I am not using the right tool/version.

The problem I encountered while editing a file is:

      "additional properties not allowed delete, put /service/{servciceId}

I did define 'put' and 'delete' operation under the above path. Not sure what I am doing wrong.

Please advise.

Aliza

[Ron Ratovsky]

The hosted swagger-editor (editor.swagger.io) is a tool you can use, yes.

If you have a specific issue with the spec, please share what you have so we can try to help out.

--
You received this message because you are subscribed to the Google Groups "Swagger" group.
To unsubscribe from this group and stop receiving emails from it, send an email to swagger-swaggers...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.