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 і REST API: у чому різниця
У REST кожен ресурс має свою адресу, а структуру відповіді визначає сервер. Через це клієнт часто отримує зайві дані або робить кілька запитів. У GraphQL одна адреса, а форму відповіді задає клієнт. Натомість REST простіше кешувати й налагоджувати, тому він залишається стандартом для більшості API.
Часті запитання
Чи замінить GraphQL REST API?
Ні, вони співіснують. REST простіший, краще кешується на рівні HTTP і підходить для більшості сервісів. GraphQL виграє там, де багато різних клієнтів і складні зв’язки між даними. Часто в одній компанії є обидва підходи.
Що таке схема в GraphQL?
Це опис усіх типів даних і операцій, доступних в API: які об’єкти є, які поля вони мають і яких типів, які запити й мутації можна виконати. Схема одночасно є документацією і контрактом між фронтендом і бекендом.
Що таке мутація в GraphQL?
Операція, яка змінює дані: створює, оновлює або видаляє записи. Наприклад, оформлення замовлення чи зміна профілю. Як і в запитах, у мутації клієнт вказує, які поля хоче отримати у відповіді після зміни.
Які мінуси в GraphQL?
Складніше кешування, бо всі запити йдуть на одну адресу. Ризик дуже важких запитів, які навантажують сервер, — їх обмежують за глибиною і складністю. І вищий поріг входу для команди: потрібно освоїти схему, обробники та інструменти.
Навчання програмуванню в OWU
Опануйте професію в IT на практичних курсах із менторами та реальними проєктами.
Обрати курс