GraphQL vyvinul Facebook v roce 2012 (open-source od roku 2015) jako řešení problémů s efektivitou mobilních aplikací. Je to silně typovaný jazyk, který umožňuje klientům získat všechna potřebná data v rámci jediného síťového požadavku.

V tradičním RESTu musíte často volat několik adres (např. `/uzivatel/1` a pak `/uzivatel/1/prispevky`), abyste získali kompletní data. GraphQL to mění:

• Jeden koncový bod (Endpoint): Všechny dotazy směřují na jednu URL (typicky `/graphql`).
• Žádné Over-fetching: Klient nedostává zbytečná data, která nepoužije.
• Žádné Under-fetching: Klient získá vše v jednom dotazu, nemusí posílat další požadavky pro související data.

—

Provoz GraphQL stojí na třech základních operacích:

• Query (Dotaz): Používá se pro čtení dat (ekvivalent GET v RESTu).
• Mutation (Mutace): Používá se pro zápis, úpravu nebo mazání dat (ekvivalent POST, PUT, DELETE).
• Subscription (Odběr): Umožňuje serveru posílat data klientovi v reálném čase přes WebSockety (např. pro chat).

—

Srdcem každého GraphQL API je Schema, které definuje, jaká data jsou dostupná. Používá k tomu jazyk SDL (Schema Definition Language).

# Definice typu na serveru
type Uzivatel {
  id: ID!
  jmeno: String!
  email: String
  prispevky: [Prispevek]
}

# Dotaz od klienta
query {
  uzivatel(id: "42") {
    jmeno
    email
  }
}

—

GraphQL neříká, jak máte data ukládat. Na serveru existují funkce zvané Resolvery, které mají za úkol „vyřešit“ (získat) konkrétní pole dotazu. Jeden resolver může sahat do SQL databáze, druhý do NoSQL a třetí může volat úplně jiné API.

—

—

• Apollo Server/Client: Nejrozšířenější ekosystém pro JavaScript/TypeScript.
• HotChocolate: Špičková implementace pro .NET.
• GraphiQL / Playground: Interaktivní prohlížeč pro testování dotazů přímo v prohlížeči.

Související články:

• REST API: Klasický přístup
• Formát JSON
• Webový vývoj v .NET

Tagy: programming api graphql facebook web-development backend query-language