Vad är GraphQL?

Önskar du att ett API gav dig exakt det du bad om? GraphQL är ett frågespråk för API:er som låter klienter begära precis de data de behöver.

REST-endpoints returnerar en fast datastruktur, så ni råkar ut för för mycket data – ni ber om en användares namn men laddar ner hela profilen och slösar bandbredd.

Motsatsen är för lite data: en endpoint räcker inte, så ni kedjar anrop för användare, sedan inlägg och därefter kommentarer – många rundresor som gör arbetet långsammare.

GraphQL löser båda problemen: klienter ber om exakt de fält de behöver från en enda endpoint, så ni får färre förfrågningar och mindre dataöverföring.

I centrum för varje GraphQL-API finns dess schema – kontraktet. Det definierar alla typer som klienter kan fråga efter och hur de hänger ihop, skrivet i SDL.

Typer definieras i SDL. Här har en User fälten id, name och email; ! markerar ett fält som icke-nullbart.

En query är det sätt på vilket en klient begär data. Den speglar den struktur ni vill ha och hämtar endast de fält ni listar – även från nästlade objekt.

Här är en enkel query: be bara om id och name, så är det allt servern returnerar för användaren med id 1. Inget extra.

Varför välja GraphQL? Effektiv datahämtning, ett starkt typat schema som förebygger fel, smidig utveckling av API:et och utmärkta verktyg som GraphiQL.

GraphQL passar särskilt bra för komplexa, sammanlänkade data, flera klientplattformar mot samma API, gateways för mikrotjänster och snabba iterationer i frontend.

Nu kan ni grunderna: GraphQL eliminerar problemet med för mycket och för lite data, schemat är kontraktet och frågor begär exakt det ni vill ha. Nästa steg är Spring Boot.