Phone icon Зв'язатись з нами

API та інтеграції

Що таке GraphQL?

GraphQL — це мова запитів до API і спосіб його побудови, за якого клієнт сам описує, які дані йому потрібні. Сервер повертає рівно ці поля — не більше і не менше — у форматі JSON.

У GraphQL зазвичай одна адреса для всіх запитів. Усі доступні дані описані схемою з типами: які є об’єкти, які в них поля і як вони пов’язані. Завдяки схемі клієнт знає, що можна запитати, а сервер перевіряє кожен запит до виконання.

Є три види операцій: запити (query) для читання, мутації (mutation) для зміни даних і підписки (subscription) для отримання оновлень у реальному часі. GraphQL створили у Facebook для мобільного застосунку і відкрили для всіх у 2015 році.

Де застосовується

GraphQL використовують там, де різним клієнтам потрібні різні набори даних: вебсайту — багато полів, мобільному застосунку — лише найнеобхідніші. Його обирають для складних інтерфейсів, де одна сторінка показує дані з багатьох джерел, і для API, яким користуються зовнішні розробники.

Фронтенд-розробник працює з GraphQL через клієнти на кшталт Apollo Client або urql, а бекенд-розробник описує схему й пише обробники полів. У вакансіях GraphQL зазвичай іде як плюс до REST API, а не замість нього.

Приклад

Сторінці профілю потрібні ім’я користувача і три останні замовлення з сумами. У REST це могло б бути два-три запити до різних адрес. У GraphQL — один запит, і у відповіді лише потрібні поля.

query {
  user(id: 42) {
    name
    orders(last: 3) {
      id
      total
    }
  }
}
Запит GraphQL: клієнт сам визначає структуру відповіді.

GraphQL і REST API: у чому різниця

У REST кожен ресурс має свою адресу, а структуру відповіді визначає сервер. Через це клієнт часто отримує зайві дані або робить кілька запитів. У GraphQL одна адреса, а форму відповіді задає клієнт. Натомість REST простіше кешувати й налагоджувати, тому він залишається стандартом для більшості API.

Часті запитання

Чи замінить GraphQL REST API?

Ні, вони співіснують. REST простіший, краще кешується на рівні HTTP і підходить для більшості сервісів. GraphQL виграє там, де багато різних клієнтів і складні зв’язки між даними. Часто в одній компанії є обидва підходи.

Що таке схема в GraphQL?

Це опис усіх типів даних і операцій, доступних в API: які об’єкти є, які поля вони мають і яких типів, які запити й мутації можна виконати. Схема одночасно є документацією і контрактом між фронтендом і бекендом.

Що таке мутація в GraphQL?

Операція, яка змінює дані: створює, оновлює або видаляє записи. Наприклад, оформлення замовлення чи зміна профілю. Як і в запитах, у мутації клієнт вказує, які поля хоче отримати у відповіді після зміни.

Які мінуси в GraphQL?

Складніше кешування, бо всі запити йдуть на одну адресу. Ризик дуже важких запитів, які навантажують сервер, — їх обмежують за глибиною і складністю. І вищий поріг входу для команди: потрібно освоїти схему, обробники та інструменти.

Навчання програмуванню в OWU

Опануйте професію в IT на практичних курсах із менторами та реальними проєктами.

Обрати курс