About GraphQL

Example 1 - Query

Query

query HeroNameAndFriends {
  hero {
    name
    friends {
      name
    }
  }
}

Show More

Result

{
  "data":{
    "hero":{
      "name":"R2-D2",
      "friends":[
        {
          "name":"Luke Skywalker"
        },
        {
          "name":"Han Solo"
        },
        {
          "name":"Leia Organa"
        }
      ]
    }
  }
}

Show More

See this Tutorial on GraphQL queries for more information on queries.

Example 2 - Mutation

Mutation

mutation CreateReviewForEpisode($ep: Episode!, $review: ReviewInput!) {
  createReview(episode: $ep, review: $review) {
    stars
    commentary
  }
}

Variables:
{
  "ep":"JEDI",
  "review":{
    "stars":5,
    "commentary":"This is a great movie!"
  }
}

Show More

Result

{
  "data":{
    "createReview":{
      "stars":5,
      "commentary":"This is a great movie!"
    }
  }
}

Show More

See this Tutorial on GraphQL mutations for more information on mutations.

When the schema of the data is known, you can query for and change the information in the exact shape the data is organized. Moreover, you will only fetch the data you need. In contrast, REST APIs respond with a predefined payload, regardless of whether you need all the information or not.

For more information on GraphQL, see:

• How to GraphQL
• Introduction to GraphQL

The Manufacturing Data Model API provides a unified interface by federating multiple services. For example; to deal with Hubs, Projects and Folders, you typically would have to deal with the Data Management REST API. Manufacturing Data Model API, based on GraphQL service handles the interaction with Data Management, providing you with a unified API experience.