Allow importing of GraphQL schemas using a URL

[galvesribeiro]

After the kind comment here and the thread being locked, I've decided to open this issue as I know other people is waiting for proper GraphQL support like myself.

Is your feature request related to a problem? Please describe.

1. The current GraphQL support rely on people having to describe the schema on the API tabs but doesn't allow people to import the schema using the introspection endpoint, which is how everyone else does the schema import on their tools as the introspection endpoint was designed for that.
2. The auto-complete/intellisense on the request using that "imported" schema, expect people to know before hand the fields or to be reading the schema elsewhere which beats the purpose of import the schema.

Describe the solution you'd like

1. On the API tab, when adding a new API, click on "Add schema" would give you an option "Import from URL" which would take an endpoint URL to GraphQL so introspection can be used. In fact, it could expect any OpenAPI schema as well, but that is for another feature request.
2. Whenever I press ctr/cmd+space, we want the list of fields for that given context. Just like any other tools have.

Additional context
Check how Insomnia, GraphiQL or GraphQL Playground. They are enough to make postman customers happy. Simple and direct to the point.

[ebonertz]

Agreed! This would be hugely helpful. At a minimum supporting an Introspection Query Response in JSON format would be nice too. I don't have the SDL schema available to me. Any plans to add this functionality in the near future?

[a85]

@ebonertz Yes. This feature is still in beta along with our APIs feature. We are gathering use cases from different users. In our head, the mental model is that the schema lives "somwhere" - the somewhere can be a repository, a server URL, or some package. Postman will treat these as sources and integrate with these sources to allow for loading the schema dynamically. GraphQL calls it "introspection" but it is the same idea across multiple schema driven flows that I have come across.

[ebonertz]

@a85 Any updates on this topic and when we may be able to load the schema dynamically through a url or introspection query?

[talynone]

Agreed! This would be hugely helpful. At a minimum supporting an Introspection Query Response in JSON format would be nice too. I don't have the SDL schema available to me. Any plans to add this functionality in the near future?

Just an FYI, I used the following to convert the JSON formatted response to SDL:
https://www.npmjs.com/package/graphql-introspection-json-to-sdl

[ebonertz]

@talynone Thanks that worked perfectly! I was able to convert my json to SDL and then insert into my Postman API Schema

[ebonertz]

@a85 I have found a suitable work around but this would need to be manually updated each time the API is updated. Would still love to see Postman support introspection queries via url to update the schema instantly. Could you please let us know if this has been considered for implementation?

[pbrink231]

I have been using insomnia for all graphql calls and postman for rest calls.

This is the main reason I use insomnia over postman. Having the schema autocomplete makes working with it very easily.

[numToStr]

Can we expect some info on this?

Absence of introspection preventing some code first Graphql developers. Building Graphql APIs with Postman will be great for the teams who use code first approach.

[umeshp7]

As of 7.15 we have added support for collection generation from GraphQL schema. You can either use a GraphQL SDL or the introspection query result JSON and import it as a collection. This can also be done using the ‘Generate Collection’ button inside the API tab for GraphQL schemas.

Feel free to get back to us with suggestions and concerns regarding the same.

[sebastienbarre]

Could you please provide more details? Or quick walkthrough? Where would I put my GraphQL endpoint for Postman to generate the collection from? Thanks

[umeshp7]

@sebastienbarre
Hi. As I mentioned in the previous comment. For now you can only import using
GraphQL SDL or Introspection query result JSON. This can be done using the IMPORT button on the top left corner.
Here is an example using an SDL file:

This can also be done using Paste Raw Text option in the import modal.
We are working on getting support for importing through GraphQL endpoint/url as well.