API dizaino pasaulyje vyksta evoliucija nuo tradicinio REST link GraphQL. Facebook sukurtas 2015 metais, GraphQL siūlo fundamentaliai kitą požiūrį į duomenų užklausimą ir manipuliavimą. Supratimas kada naudoti kurį sprendimą tampa vis svarbesniu kompetencija šiuolaikiniam backend kūrėjui.
REST (Representational State Transfer) ilgą laiką buvo dominuojantis API architektūros stilius. Jo principai paprasti: resursai identifikuojami URL, HTTP metodai (GET, POST, PUT, DELETE) atitinka CRUD operacijas, stateless komunikacija. REST pranašumai: paprastumas ir lengvas supratimas, gerai nusistovėję standartai, HTTP caching galimybės, platus įrankių palaikymas.
Tačiau REST turi ir apribojimų. Over-fetching – gauname daugiau duomenų nei reikia. Under-fetching – reikia daryti kelis request'us gauti visus reikalingus duomenis. API versijų valdymas gali tapti sudėtingas. Dokumentacijos palaikymas reikalauja pastangų.
GraphQL sprendžia šias problemas skirtingu būdu. Vienas endpoint visiems užklausimams. Klientas nurodo tiksliai kokių duomenų reikia. Galinga type sistema užtikrina aiškumą ir validaciją. Introspection leidžia automatinį dokumentacijos generavimą. Real-time subscriptions palaiko live duomenų atnaujinimus.
GraphQL užklausos struktūra leidžia klientui aprašyti tiksliai kokių laukų reikia ir kokiose įdėtose struktūrose. Tai eliminuoja over-fetching ir under-fetching. Mutations apibrėžia duomenų keitimo operacijas, o subscriptions – real-time event'us.
Tačiau GraphQL nėra sidabrinė kulka. Sudėtingumas serverio pusėje – reikia implementuoti resolver'ius kiekvienam laukui, apsaugą nuo per sudėtingų užklausų (query depth limiting). Caching sudėtingesnis nei REST, nes užklausos gali būti labai įvairios. N+1 problemos galimybė, jei resolveriai neoptimizuoti. Mokymo kreivė stačesnė pradedantiesiems.
Kada naudoti GraphQL? Mobilios aplikacijos, kur svarbu minimizuoti duomenų perdavimą. Dashboard'ai su daug skirtingų duomenų atvaizdavimo būdų. Multi-platform aplikacijos, kur skirtingi klientai reikalauja skirtingų duomenų. Kada REST geriau? Paprastos CRUD aplikacijos. Public API, kur norite paprastumo ir aiškumo. Kai reikia maksimaliai išnaudoti HTTP caching.
Realybėje daugelis organizacijų naudoja hibridinį požiūrį – REST paprastoms operacijoms, GraphQL sudėtingesnei duomenų užklausai. Apollo Server, Hasura, Postgraphile ir kiti įrankiai palengvina GraphQL implementavimą ir integraciją su egzistuojančiomis sistemomis.