Inhaltsverzeichnis

3.1 GraphQL osnove

GraphQL1) omogoča prilagodljive, natančne podatkovne poizvedbe.

Kaj je GraphQL?

GraphQL2) je poizvedovalni jezik za API-je in izvajalno okolje za izvajanje teh poizvedb. V nasprotju z REST3) lahko odjemalci zahtevajo točno tiste podatke, ki jih potrebujejo.

Končna točka

POST /api/v1/dsn/{dbName}/graphql
Content-Type: application/json

Enostavna poizvedba

{
  "query": "{ customers { id name country } }"
}

S parametri

{
  "query": "{ customers(first: 10, filter: \"Country eq 'DE'\") { id name } }"
}

Pridobivanje sheme

GET /api/v1/dsn/demo/graphql/schema

Vrne GraphQL shemo v SDL4) obliki.

Prednosti v primerjavi z REST

Vidik REST GraphQL
Končne točke Mnogo (na vir) Ena
Over-fetching Pogosto Nikoli
Under-fetching Pogosto (N+1) Nikoli
Tipska varnost Neobvezna Vgrajena
Dokumentacija Zunanja (OpenAPI5)) Integrirana (Introspection)

Viri

1)
GraphQL specifikacija: https://spec.graphql.org/
2)
GraphQL Foundation: https://graphql.org/
3)
Representational State Transfer: https://de.wikipedia.org/wiki/Representational_State_Transfer
4)
Schema Definition Language: https://graphql.org/learn/schema/
5)
OpenAPI Specification: https://www.openapis.org/