GraphQL: od interního řešení z Facebooku z roku 2012 ke standardu API

Proč možnost tvarovat dotazy na straně klienta změnila návrh moderních API

Zajímavost

GraphQL se zrodil na Facebooku v roce 2012. Mobilní vývojáři tam bojovali s REST endpointy, které aplikaci nutily stahovat daleko víc dat, než obrazovka skutečně potřebovala - anebo kvůli jedinému zobrazení poslat několik požadavků za sebou. Odpověď byla radikální: ať si klient sám popíše přesný tvar dat, které chce dostat, a server mu vrátí přesně to a nic navíc. Facebook specifikaci otevřel světu v roce 2015 a v roce 2018 se její správa přesunula do nově vzniklé GraphQL Foundation pod křídly Linux Foundation. Schema Definition Language se oficiálně stala součástí specifikace 9. února 2018. Dnes provozují veřejná GraphQL API třeba GitHub, Shopify nebo Yelp. A jedna perlička: každé pole je ve výchozím stavu nullable a jediný vykřičník stačí, aby bylo povinné.

Stručný návod k nástroji

  1. Vložte GraphQL dotaz do editoru - formátovač mu automaticky srovná rozházené odsazení.
  2. Načtěte schéma ve formátu SDL a prozkoumejte jeho typy, pole a vztahy ve vizualizéru.
  3. Dotaz sestavte nebo upravte výběrem polí; builder přitom neustále hlídá platnou syntaxi.
  4. Hotový dotaz zkopírujte, spusťte proti svému API, nebo ho pošlete týmu.

Vyzkoušejte nástroj

GraphQL Explorer →

Další čtení

GraphQL na Wikipedii — článek na Wikipedii