Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Serializers - Paw - Export Paw groups to Postman/Swagger/RAML #72

Open
geniusescode opened this issue Sep 7, 2016 · 2 comments
Open

Comments

@geniusescode
Copy link

when exporting the API's from POW to PostMan or swagger, groups get ignored,.

@mittsh mittsh changed the title Pow - Groups Export Paw groups to Postman/Swagger/RAML Sep 7, 2016
@mittsh
Copy link
Contributor

mittsh commented Sep 7, 2016

@geniusescode Thanks for the report. I don't think we can do that actually:

  • Swagger doesn't support groups at all, but rather organizes endpoints by their path from the API root. That's what we're doing when exporting. But there's no support for custom groups, that's why they are ignored. (See Swagger 2.0 Spec)
  • Postman supports only one level of group (no nesting). Well, technically they support that in their new Postman format v2 but if we generate nested groups they are then ignored by the Postman user interface (bug or feature from them? we haven't checked tbh). The other issue with Postman format v2 is that we cannot export environment variables (not supported in v2), that's why we generate format v1. Regarding the groups, we could support group export with only the groups at the root, but we have chosen for now to put all requests under an "API-Flow imports" folder in Postman to make it clear to users.

I'll keep this issue open so we remember to check if we can support groups better when exporting to Postman.

@JonathanMontane JonathanMontane changed the title Export Paw groups to Postman/Swagger/RAML Serializers - Paw - Export Paw groups to Postman/Swagger/RAML Sep 26, 2016
@JonathanMontane JonathanMontane modified the milestones: 0.2.0, -- Future -- Sep 26, 2016
@thetutlage
Copy link

It is possible now using tags in swagger https://swagger.io/docs/specification/grouping-operations-with-tags/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants