GraphQL

GraphQL
Name	GraphQL
Developer	Facebook (now Meta)
First released	2015
Latest release	specification maintained by GraphQL Foundation
License	Open specification

GraphQL GraphQL is a data query and manipulation language with a runtime for executing queries, developed initially at Facebook and standardized by the GraphQL Foundation. It provides a declarative syntax for clients to request exactly the data they need and includes a strongly typed schema to describe capabilities, designed for flexibility across web, mobile, and server environments. GraphQL is used by companies and projects ranging from startups to large organizations integrating with services such as AWS, Google Cloud, and Microsoft Azure.

Overview

GraphQL originated at Facebook and was later published as an open specification with contributions from organizations including Meta, GitHub, Airbnb, and Shopify. Major adopters include Twitter, Netflix, PayPal, Pinterest, Coursera, GitHub, Shopify, IBM, Salesforce, Stripe, Facebook, Amazon, Microsoft, Google, LinkedIn, Uber, Lyft, Adobe, Spotify, Dropbox, Airbnb, WhatsApp, Reddit, Snapchat, Etsy, Square, Trello, Asana, Heroku, Cloudflare, Kubernetes, Docker, Zendesk, Atlassian, Expedia, Booking.com, Vercel, Netlify, DigitalOcean, MongoDB, PostgreSQL, MySQL, Oracle Corporation, SAP, Siemens, Accenture, Capgemini, Ericsson, Nokia, Qualcomm, Intel Corporation, AMD, NVIDIA, ARM Holdings, Samsung, LG Electronics, Huawei, Xiaomi, Baidu, Tencent, Alibaba Group, ByteDance, OpenAI, DeepMind, MIT, Stanford University, Harvard University, UC Berkeley, Princeton University, University of Cambridge, University of Oxford.

Design and Core Concepts

GraphQL’s design emphasizes a typed schema, client-driven queries, and a single endpoint to replace numerous REST endpoints. Influences and related technologies include REST, SOAP, XML-RPC, gRPC, JSON-RPC, OData, Falcor (Netflix), Apollo GraphQL, Relay (web framework), Graph databases, Neo4j, JanusGraph, ArangoDB, Dgraph, Amazon Neptune, Gremlin, SPARQL, RDF, Linked Data, W3C standards, IETF, RFC 7231, HTTP/2, WebSocket, gRPC-Web, Server-Sent Events, GraphQL Foundation, Linux Foundation.

Type System and Schema

The schema is a central contract defined using object types, interfaces, unions, enums, scalars, and input objects, with tools and implementations from ecosystems such as TypeScript, Flow, Rust, Go (programming language), Python (programming language), Java (programming language), Kotlin, Scala, C#, PHP, Ruby, Elixir, Haskell, OCaml, Erlang, Clojure, Dart (programming language), Swift (programming language), Objective-C, Perl, Lua (programming language), Crystal (programming language), Nim (programming language), Zig (programming language), R (programming language), MATLAB, Julia (programming language), SML. Tools for schema design and validation include projects from GraphiQL, GraphQL Playground, Insomnia, Postman, VS Code, WebStorm, JetBrains, Eclipse Foundation, IntelliJ IDEA.

Execution and Query Language

Queries, mutations, and subscriptions form GraphQL’s operation types, executed by resolver functions that map schema fields to backend data sources like SQL and NoSQL databases, message queues, and microservices. Common integrations involve PostgreSQL, MySQL, SQLite, MongoDB, Redis, Cassandra, Elasticsearch, Solr, BigQuery, Snowflake, Amazon Aurora, DynamoDB, Google Cloud Spanner, Azure Cosmos DB, Apache Kafka, RabbitMQ, AWS Lambda, Azure Functions, Google Cloud Functions, Kubernetes, Docker Swarm, Istio, Linkerd, Envoy (software), NGINX, HAProxy.

Client and Server Implementations

Prominent client and server libraries include implementations and tooling from Apollo GraphQL, Relay (web framework), Urql, Hasura, Prisma, Graphene (Python), Sangria (Scala), Absinthe (Elixir), graphql-java, graphql-ruby, Hot Chocolate (software), Netflix DGS Framework, FaunaDB, Supabase, AppSync (AWS), Azure API Management, Google Cloud Endpoints, Kong (software), Tyk (API Gateway), PostgREST, Graphcool, RedwoodJS, Next.js, Nuxt.js, Gatsby (software), Create React App, React (JavaScript library), Angular (web framework), Vue.js, Svelte, Flutter, React Native, Ionic (software), Electron (software), Xamarin, NativeScript.

Use Cases and Adoption

GraphQL is used for mobile data efficiency, single-page application development, microservices composition, and BFF (Backend for Frontend) patterns in enterprises. Notable project and platform use cases include integrations at Facebook, GitHub, Shopify, Twitter, Pinterest, Instagram, Times (The New York Times), BBC, The Guardian, Wikimedia Foundation, Stack Overflow, Medium (website), Flickr, SoundCloud, Deezer, Hulu, HBO, Disney, The Walt Disney Company, Comcast, Verizon Communications, AT&T, T-Mobile US, Vodafone Group, Orange S.A., Deutsche Telekom, BT Group.

Criticisms and Limitations

Criticisms include complexity for caching and CDN integration compared to REST, challenges in rate limiting and analytics, and potential for overly complex queries requiring query depth limiting and persisted queries. Operational concerns relate to monitoring and tracing using tools from Prometheus, Grafana, New Relic, Datadog, Splunk, Elastic (company), Jaeger (software), Zipkin, OpenTelemetry, Sentry, Honeycomb (software), PagerDuty.

Category:Application layer protocols