cheatsheets/graphql.md

title	category
GraphQL	Misc

Queries

{ status }
// → { status: 'available' }

Nesting

{ hero { name height } }
// → { hero:
//     { name: "Luke Skywalker",
//       height: 1.74 } }

Lookups

{
  hero(id: "1000") { id name }
}
// → { hero:
//     { id: "1000",
//     { name: "Luke Skywalker" } }

Aliases

{
  luke: hero(id: "1000") { name }
  han: hero(id: "1001") { name }
}
// → { luke:
//     { name: "Luke Skywalker" },
//     han:
//     { name: "Han Solo" } }

Variables

{ hero(id: $id) }  // Query
---
{ id: '1000' }     // Variables

Operation name

Just to make things less ambiguous.

query FindHero($id: String) {
  hero(id: $id) { name }
}

Mutations

Mutations are just fields that do something when queried.

{ createReview($review) { id } }  // Query
---
{ review: { stars: 5 } }          // Variables
// → { createReview: { id: 5291 } }

Over HTTP

// Get
fetch('http://myapi/graphql?query={me{name}')

POST

// Post
fetch('http://myapi/graphql', {
  body: JSON.stringify({
    query: "...",
    operationName: "...",
    "variables": { ... }
  })
})


References
----------

- <http://graphql.org/learn/queries/>
- <http://graphql.org/learn/serving-over-http/>