All specs
GraphQL June 2018GraphQLShould KnowProductAPI Design2018

GraphQL Specification

API Design·GraphQL Foundation
WHY YOU NEED THIS

GraphQL solves over-fetching and under-fetching in complex UIs. If your frontend needs flexible, composable data queries across multiple entity types, GraphQL is the tool.

What It Defines

Defines the GraphQL query language, type system, introspection, execution model, and response format. Clients specify the exact data shape they need; the server returns exactly that. Single endpoint, typed schema.

Canonical (Normative)

Convenient (Practical)

graphqlapiquery-languageschema
Standards Body
GraphQL Foundation

Stewards the GraphQL specification, originally developed at Facebook/Meta. The GraphQL Foundation is a Linux Foundation project. The spec defines the query language, type system, and execution model.

Visit

Related Specs

OpenAPI 3.1.0RFCMust Know

OpenAPI 3.1

OpenAPI is the de-facto standard for API documentation, code generation, mock servers, and contract testing. Most APIs you build should have an OpenAPI spec.

ProductAPI DesignAPI Design
Details
RFC 8259RFCMust Know

JSON

JSON is the lingua franca of web APIs. RFC 8259 is short and worth reading once — it clarifies edge cases around numbers, encoding, and trailing commas.

ProductData Formats
Details
RFC 9110RFCMust Know

HTTP Semantics

This is the core contract of every web API, browser request, and server response. You can't design or debug HTTP without knowing this.

ProductHTTP
Details