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 на практических курсах с менторами и реальными проектами.
Выбрать курс