GraphQL: The basics

GraphQL is a data aggregation framework designed to make accessing, updating, and creating data easier. It acts very similar to REST in the sense that it is a design spec on how to structure your API, like REST there are pre-built solutions you can implement which we will go over later in this post.


The syntax is based on extracting information from an endpoint and returning it in a JSON object. The querying syntax looks the same as the object you want to receive back.

  me {
  "me": {
    "name": "Luke Skywalker"

Getting the data

Now you might be wondering how GraphQL is able to access the data and return it. This is done via getter functions, the functions are defined like below:

function Query_me(request) {
  return request.auth.user;

function User_name(user) {
  return user.getName();

These functions will get the user me using the Query_me function, then pass that data to the User_name function to grab the user's name.


Features GraphQL REST
Create X X
Update X X
Read X X
Fine Control over data X

GraphQL and REST are very similar, the main difference is GraphQL lets you control the data you are getting. Because of this you don't need to make multiple REST endpoints to collect the data you need, all of it can be sent as needed from a single endpoint.


GraphQL is not a database, it is only a query language. Here are a few databases that support GraphQL:

  • MongoDB
  • Redis
  • SQL If you want to know how to use these databases with GraphQL, you can visit this resource to learn more.

Where to use GraphQL

GraphQL can be used on the front end or the back end, using it on the front end can be a great way to speed up requests. This is done by only requesting the data you need from the server and batching it all into one request. It also works great for backend-to-backend API requests, by benefiting from the same savings.

When to use GraphQL

GraphQL really only makes a difference when complexity grows in an application. It doesn't make sense to use it for small applications or applications where the data being requested is simple. Companies that use it are Shopify, Facebook, GitHub, and Pinterest. For them it makes sense, they are searching complex datasets and have a massive amount of data to store.



Be the first to comment!

Read More

Image of a keychain with the word SEO on it
Image of a keychain with the word SEO on it

Basics of SEO in HTML

Search engine optimization (SEO) is the process of improving the visibility and ranking of a website in search engines like Google. It involves making changes to the website's ...

Installing Nginx on Ubuntu

NGINX (pronounced "engine x") is a free, open-source, high-performance HTTP server and reverse proxy. It is known for its high performance and low resource consumption, making it a popular choice for web servers and microservi...

Making sticky elements in HTML and CSS.

Sticky elements are a useful feature in modern web design, as they allow certain elements on a webpage to remain visible even when the user scrolls. This can be useful for elements such as the n...