luckymarmot / API-Flow

Universal data structure and converter for API formats (Swagger, RAML, Paw, Postman…)
MIT License
193 stars 24 forks source link

Parser - Postman - Convert Folders to Tags #155

Open philsturgeon opened 6 years ago

philsturgeon commented 6 years ago

Common convention is to use folders to group actions together, and OpenAPI generally use tags for that.

Postman

screen shot 2017-12-19 at 10 18 15 pm

OpenAPI (in Redoc)

screen shot 2017-12-19 at 10 19 42 pm

When tags are involved, Redoc looks a little more like this:

screen shot 2017-12-19 at 10 20 51 pm

"PET and "STORE" are tags, and the other items are "operations".

Do you folks think it makes sense to turn Postman Folders into Tags?