Какво е GraphQL?

GraphQL е език за заявки към API и среда за изпълнение на тези заявки. Той позволява на клиента да поиска точно онези данни, които му трябват, като дефинира структурата на отговора. За разлика от традиционните REST API, където се искат крайни точки, GraphQL изпраща заявка към една крайна точка, специфицирайки необходимите полета.

Основни концепции на GraphQL:

• Схема (Schema): Определя наличните типове данни, операциите (заявки, мутации, абонаменти) и връзките между типовете. Пише се на Schema Definition Language (SDL).
• Типове (Types): Определят структурата на данните. Могат да бъдат скаларни (String, Int, Float, Boolean, ID), потребителски или типове-контейнери (Lists, Non-Null).
• Заявки (Queries): Използват се за получаване на данни от сървъра. Клиентът указва кои полета са нужни, и сървърът връща данните само за тези полета.
• Мутации (Mutations): Използват се за промяна на данните на сървъра (създаване, актуализиране, изтриване). Подобни са на заявки, но ясно указват промяна на състоянието.
• Абонаменти (Subscriptions): Позволяват на клиента да получава актуализации в реално време при промени на данните на сървъра.

Предимства на GraphQL:

• Ефективност: Клиентът заявява само необходимите данни, което намалява обема на предаваната информация и предотвратява излишното (overfetching).
• Гъвкавост: Клиентът сам определя структурата на отговора, което улеснява разработката и еволюцията на API.
• Подобрена производителност: Ефективното получаване на данни може да ускори зареждането на страниците.
• Строга типизация: Схемата осигурява ясно определен договор между клиента и сървъра, което улеснява валидирането и откриването на грешки.

Пример за заявка:

query GetUser {
  user(id: "123") {
    name
    email
    posts {
      title
    }
  }
}

Пример за мутация:

mutation CreatePost {
  createPost(input: { title: "Нов Пост", content: "..." }) {
    id
    title
  }
}