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

Add GraphQL support #1669

Open
rayshan opened this Issue Jan 19, 2016 · 49 comments

Comments

@rayshan

rayshan commented Jan 19, 2016

Hello,

GraphQL is a query language created by Facebook for describing data requirements on complex application data models. It's frequently used with React and Relay.

References:
http://graphql.org/
IDE: https://github.com/graphql/graphiql

@tribou

This comment has been minimized.

tribou commented Aug 22, 2016

I would like to second this issue. Postman has an opportunity to communicate to an existing GraphQL API using the introspection query and provide auto-complete for queries similar to the existing GraphiQL implementation. Combined with Postman's existing feature-set of saved queries and environment management, it could make Postman my go-to app for testing during GraphQL API development.

May we get an update as to the consideration of this?

@a85

This comment has been minimized.

a85 commented Sep 7, 2016

@tribou We are super interested in extending Postman to things beyond HTTP but have been super swamped with the current workload. :(

@tribou

This comment has been minimized.

tribou commented Sep 8, 2016

@a85 I understand, and thank you for the kind response. A quick clarification... GraphQL can actually communicates with JSON over HTTP using POST calls. With this being an example GraphQL query:

{
  viewer(authToken: "12345") {
    users {
      id
      name
      phone
      status
      createdAt
      updatedAt
    }
  }
}

The resulting full example query using curl looks like this:

curl -XPOST http://localhost:8080/graphql \
  -d '{ "query": "{ viewer(authToken: \"12345\") { users { id name phone status createdAt updatedAt } } }", "variables": null }'

Consequently, I'm actually able to use Postman to test and save queries now. However, the awkward string formatting required to translate the GraphQL query into JSON is what makes it difficult...and provides an opportunity for Postman. 😄

@a85

This comment has been minimized.

a85 commented Sep 15, 2016

@tribou Awesome. We'll add this asap.

@hkgill

This comment has been minimized.

hkgill commented Feb 27, 2017

+1

3 similar comments
@jazzdragon

This comment has been minimized.

jazzdragon commented Mar 8, 2017

+1

@daviskoh

This comment has been minimized.

daviskoh commented Apr 24, 2017

+1

@dh94

This comment has been minimized.

dh94 commented Apr 25, 2017

+1

@a85

This comment has been minimized.

a85 commented Apr 25, 2017

Sorry about the delay on this folks. This got held up as we have been refactoring parts of the app to enable more modularization. GraphQL is high on our radar overall. I'll update the thread once we have more info to share. Thanks for your patience.

@DraganKovacevic

This comment has been minimized.

DraganKovacevic commented May 10, 2017

Are we there yet?

@ultymike

This comment has been minimized.

ultymike commented May 22, 2017

+1

5 similar comments
@BenGale

This comment has been minimized.

BenGale commented May 28, 2017

+1

@cdelgadob

This comment has been minimized.

cdelgadob commented May 29, 2017

+1

@Strutsagget

This comment has been minimized.

Strutsagget commented Jun 8, 2017

+1

@atalebagha

This comment has been minimized.

atalebagha commented Jun 28, 2017

+1

@stevenb9

This comment has been minimized.

stevenb9 commented Jul 13, 2017

+1

@batjko

This comment has been minimized.

batjko commented Jul 13, 2017

@nithincscubet I don't think that would make sense, since GraphQL itself has no concept of file uploads yet.

@tribou

This comment has been minimized.

tribou commented Jul 14, 2017

@madebysid @numaanashraf @a85 I'd love to get an update on this feature. This issue has been open for a year and a half now; and with the proliferation of GraphQL, I would have expected more progress (or at least more communication).

I think you've got two incredible opportunities for Postman, and you don't need to try to tackle both at once:

  1. Support the GraphQL syntax in Postman to send API calls
  2. Implement the GraphQL introspection query to provide autocomplete

I would think that item 1 would be more quickly attainable and would actually alleviate most of the pain currently felt when trying to use GraphQL with Postman--just make it easy to type in a GraphQL query and automatically format it into the appropriate JSON for the API call. Item 2 is more for convenience and UX, which would obviously be a huge win and would keep more users in the Postman ecosystem than have them migrate to GraphiQL or similar. However, it doesn't address the current pain like item 1, so I could understand if item 2 needed to be delayed further.

Please, take a moment to provide us with an update or a link to the current progress. Thank you!

@madebysid

This comment has been minimized.

madebysid commented Jul 19, 2017

@tribou This is definitely something we're looking into. I agree that supporting the GraphQL syntax should be quickly doable.
I'd also suggest looking at out roadmap, which we'll update with GraphQL status soon. Thanks for the patience! :)

@horacehylee

This comment has been minimized.

horacehylee commented Aug 24, 2017

+1

@batjko

This comment has been minimized.

batjko commented Aug 24, 2017

Just to add inspiration, the way Insomnia does it, is essentially what we're after here.
It even has automatic introspection, so works similarly to GraphiQL (though I haven't been able to make that one work when I briefly tried). But even without that, a simple GraphQL query editor would suffice to start.

image

@webmobiles

This comment has been minimized.

webmobiles commented Oct 23, 2017

yes I'm working well with Insomnia, option for variables; auth bearer, but sync for 5$ monthly, postman will be paid?

@consolibyte

This comment has been minimized.

consolibyte commented Nov 14, 2017

+1

@Fohlen

This comment has been minimized.

Fohlen commented Dec 2, 2017

This is a crucial tool for every 2017 and 2018 backend engineer. When can we expect that feature to be shipped?

@cdelgadob

This comment has been minimized.

cdelgadob commented Dec 2, 2017

@Fohlen

This comment has been minimized.

Fohlen commented Dec 2, 2017

I was especially referring the trend of serverless architectures because not all of them (erm erm, Lambda!) do ship GraphiQL by themselves.

@jakubkratina

This comment has been minimized.

jakubkratina commented Dec 24, 2017

+1

@zocheyado

This comment has been minimized.

zocheyado commented Jan 2, 2018

Any update on this? Insane that this is not a key feature of postman in 2018.

@a85

This comment has been minimized.

a85 commented Jan 4, 2018

Everyone,

Thank you for your patience with this feature. We are super excited about GraphQL. Postman is being re-written to operate through a plugin based architecture. This will help us support API design/definition/schema formats (RAML, GraphQL, Swagger - even SOAP) properly and ship updates as soon as versions of these format tick up rather than having to update Postman itself. We want to support schemas as first-class editable entities in Postman so you can update related collections/requests automatically by updating the schema.

Right now we are making some fundamental changes in the code base for performance and stability - this will improve load times, render times as well as sync performance. More updates soon on this thread and on our blog! Lots coming up in 2018!

Abhinav

@valnub

This comment has been minimized.

valnub commented Feb 15, 2018

Is there an ETA for this?

Currently we're forced to use Insomnia but we'd much more prefer Postman for automated testing.

@dashmug

This comment has been minimized.

dashmug commented Feb 27, 2018

I'm using Insomnia for this. But will go back to using Postman once this feature is up.

Make it happen guys!

@jrichard0725

This comment has been minimized.

jrichard0725 commented Mar 10, 2018

Could really use a postman graph feature. Been holding off on switching my team in hopes this feature will come along soon....not sure how much longer we can afford to wait.

Really need this to come through for our team to stay on Postman...

@fharper

This comment has been minimized.

fharper commented Apr 5, 2018

+1

@mobiustech

This comment has been minimized.

mobiustech commented Apr 22, 2018

TIL, postman doesn't support GraphQL. This issue was raised more than 2 years ago...

@PathToLife

This comment has been minimized.

PathToLife commented Apr 24, 2018

Quote from: https://stackoverflow.com/questions/42520663/how-to-send-graphql-query-by-postman
"I think POSTMAN is not made for work naturally with graphql"

Just use: https://insomnia.rest/

POSTMAN is still great though, it's just new protocols and technologies will always happen.
Is the extra development time and increased complexity worth it? ~~~

The UI is pretty complex already imo, learning how to save responses (examples) was a pain.

@mortik

This comment has been minimized.

mortik commented May 28, 2018

Insomnia is a very good Tool but it lacks a very important feature for me: Tests :) which can also be used to update env vars ^^ and to run complete Collections.

For me it would be enough, as a first step, to have a way to write multiline queries and without a js workaround...

@joshprice

This comment has been minimized.

joshprice commented Jun 4, 2018

What doesn't seem to have been mentioned yet is the ability to send GraphQL queries as plain text rather than jumping through hoops trying to make it JSON. (You don't get introspection or autocomplete obviously but it's an improvement). Here's how to do it:

Send a POST with a Content-Type of application/graphql then your body can be a plain text query document (as described here https://graphql.org/learn/serving-over-http/#post-request).

Most GraphQL servers should support this (if not they should).

Some other options worth investigating are:

For anyone like me who is curious about the status, the Postman support ticket is still listed as "mid term" despite having 72 votes (more might help?).

https://trello.com/c/u4DE4WU8/58-graphql-support

@a85 a85 added the Plugin label Jun 16, 2018

@macalinao

This comment has been minimized.

macalinao commented Jun 18, 2018

plus one. Insomnia also doesn't support the header preset stuff which is useful for auth tokens in headers.

@smeijer

This comment has been minimized.

smeijer commented Jun 18, 2018

@macalinao, I'm using auth tokens in headers just fine with Insomnia

@a85 a85 self-assigned this Jun 29, 2018

@shahidhk

This comment has been minimized.

shahidhk commented Aug 10, 2018

We recently made a tool called graphqurl (https://github.com/hasura/graphqurl) for making GraphQL queries with custom headers etc. It's a CLI that has auto-complete, can open GraphiQL on any endpoint (with support for custom headers), supports subscriptions and can be used as a JS library. Let us know if you find it useful.

gq https://gentle-anchorage-72051.herokuapp.com/v1alpha1/graphql -i will open up GraphiQL shown below:
image

@websitevirtuoso

This comment has been minimized.

websitevirtuoso commented Aug 28, 2018

+1

1 similar comment
@mrljdx

This comment has been minimized.

mrljdx commented Aug 30, 2018

+1

@andreas-bergstrom

This comment has been minimized.

andreas-bergstrom commented Sep 20, 2018

What's the status here? I'd happily support a Kickstarter to get this done. As long as it has the same feature set as Postman for REST, including Tests (which Insomnia lacks).

@shashikiran797

This comment has been minimized.

shashikiran797 commented Oct 9, 2018

+1

Eagerly waiting for graphql support on postman

@joelgetaction

This comment has been minimized.

joelgetaction commented Nov 2, 2018

I would be willing to pay for this ... Any updates or ETA? :-)

@cphoover

This comment has been minimized.

cphoover commented Nov 6, 2018

Is this still on the road map??

@cardosomarcos

This comment has been minimized.

cardosomarcos commented Nov 7, 2018

@cphoover Yes, it is. You can check the roadmap here:
https://trello.com/c/u4DE4WU8/58-graphql-support

@joelgetaction

This comment has been minimized.

joelgetaction commented Nov 7, 2018

@cardosomarcos thanks for responding. I took a look at the Trello card but the last activity was August 2017 when it went to "planning" ... That was more than a year ago.

I would like to move my team to a paid Postman plan, however lack of GraphQL support is holding us back. Any ETA for when this will be done? We'd rather stick with Postman than switch to another tool, but we really need GraphQL support and I'm hearing this from a lot of other developers as well. :-)

Thanks!

@bastos71

This comment has been minimized.

bastos71 commented Nov 13, 2018

Any idea of a release date ?

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