Что такое GraphQL: как работает и чем отличается от REST

Что такое GraphQL: как работает и чем отличается от REST
0
14

На сайте интернет-магазина нужно показать товар: название, цену, фотографии и доступные размеры. Все эти сведения хранятся на сервере, но для разных страниц требуется разный набор данных. GraphQL позволяет сайту запрашивать только нужную информацию, не получая всё остальное. Объясняем, как устроен этот язык запросов, чем он отличается от REST и где его можно попробовать.

Что такое GraphQL простыми словами

GraphQL — это язык запросов к API, с помощью которого приложение выбирает, какие данные хочет получить от сервера. Например, интернет-магазин может запросить название товара и цену для каталога, а для подробной карточки дополнительно получить описание, фотографии и варианты размеров.

Чтобы понять GraphQL, сначала разберёмся с API. Это способ, которым программы обмениваются данными и обращаются к функциям друг друга. Когда вы открываете личный кабинет, сайт может получить через API сведения о вашем аккаунте, заказах или доступном балансе. Подробнее этот принцип мы объясняли в статье «API — что такое программный интерфейс».

GraphQL определяет, как составлять такие запросы. Разработчик перечисляет необходимые поля, а сервер возвращает их значения, если они доступны и у приложения есть права на получение информации.

Сам GraphQL не хранит товары, заявки или пользователей. Данные могут находиться в обычной базе, CRM или другом сервисе. GraphQL помогает приложению обращаться к ним по заранее установленным правилам.

Технологию начали разрабатывать в Facebook в 2012 году, а в 2015 году представили публично. Сейчас её используют для работы сайтов, мобильных приложений, интернет-магазинов и аналитических сервисов.

Как работает GraphQL

Возьмём страницу интернет-магазина. Покупатель открывает карточку свитера, а сайт обращается к серверу за информацией о товаре.

Разработчик заранее определил, что на этой странице нужны название, фотография, цена и доступные размеры. Через GraphQL он может составить запрос именно к этим данным.

Процесс выглядит следующим образом:

  1. Сайт отправляет запрос с перечнем необходимых полей.
  2. Сервер проверяет, существуют ли такие поля и разрешён ли доступ к ним.
  3. Сервер получает сведения из подключённых источников.
  4. Сайт получает ответ и показывает информацию покупателю.

Посмотрим на небольшой пример из Shopify — платформы для создания интернет-магазинов.

{

  product(handle: "wool-sweater") {

    title

    featuredImage {

      url

    }

  }

}

Здесь product означает, что приложение запрашивает товар. Значение wool-sweater помогает найти конкретную позицию в каталоге. А поля title и featuredImage указывают, что нужны название и основная фотография.

Если добавить в запрос сведения о цене, сервер сможет вернуть и их — при условии, что нужные поля предусмотрены API. В Shopify для этого есть, например, priceRange.

Это пример синтаксиса на основе настоящего Shopify Storefront API, а не запрос, выполненный к конкретному магазину. Для работы с данными магазина необходимо подключиться к его API и получить предусмотренный доступ.

Редактор GraphiQL с GraphQL-запросом, переменными и ответом сервера в формате JSON.
Слева разработчик указывает нужные поля, справа получает данные в соответствующей структуре.

Что такое схема GraphQL

У каждого GraphQL API есть схема (Schema) — описание того, какую информацию можно запрашивать и какие действия доступны приложению.

Например, схема интернет-магазина может содержать сведения о товарах, заказах и покупателях. Для товара будут предусмотрены отдельные поля: название, цена, описание, изображения и другие характеристики.

Разработчик выбирает поля из этой схемы. Если он укажет несуществующее название, сервер сообщит об ошибке. Кроме того, даже доступные в схеме данные могут требовать авторизации.

Благодаря схеме инструменты для работы с GraphQL умеют подсказывать названия полей. Это удобно: разработчику не приходится запоминать все возможности API.

Чем GraphQL отличается от REST API

REST и GraphQL позволяют программам обмениваться данными, но делают это по-разному.

В REST API для получения информации обычно обращаются к определённым адресам. Например, один адрес возвращает сведения о товаре, другой — отзывы о нём, третий — данные продавца.

В GraphQL запрос строится иначе: приложение выбирает необходимые поля из доступной схемы. Если сервер поддерживает связи между товарами, отзывами и продавцами, эти сведения можно получить одной операцией.

КритерийREST APIGraphQL
Как запрашивают данныеОбращаются к адресам ресурсовВыбирают поля в запросе
Кто определяет состав ответаОбычно серверКлиент в пределах доступной схемы
Получение связанных данныхМожет потребоваться несколько запросовЧасто достаточно одного запроса
ДокументацияОписывает адреса и операции APIОписывает типы данных, поля и операции
Начало работыЧасто проще для небольшого проектаТребует понимания схемы и запросов

Разница особенно заметна, когда у одного сервиса несколько интерфейсов. Например, на сайте партнёрской сети вебмастер видит подробную статистику, а в мобильной версии — только баланс и количество заявок за день.

В REST API разработчики могут предусмотреть отдельные ответы для каждого интерфейса. В GraphQL приложение само выбирает нужные поля из разрешённых.

При этом REST тоже можно настроить так, чтобы сервер возвращал только необходимые данные. Поэтому считать GraphQL более совершенной заменой REST было бы неправильно.

GraphQL не обязательно работает быстрее. Он помогает уменьшить количество лишних данных и иногда позволяет обойтись меньшим числом обращений к серверу. Но скорость зависит от сложности запроса и того, как устроена серверная часть.

Для простого лендинга или небольшого сервиса REST может быть удобнее. GraphQL чаще выбирают там, где много связанных данных, сложные интерфейсы и разные приложения используют один API.

Какие запросы бывают в GraphQL

Через GraphQL приложение может получать информацию, изменять её и подписываться на обновления. Для этого предусмотрены три основных типа операций.

Query — получение данных

Query используют, когда нужно прочитать информацию с сервера.

Например, показать список товаров, получить данные аккаунта или загрузить статистику рекламных кампаний. Разработчик указывает, какие именно сведения необходимы приложению.

В предыдущем примере с Shopify мы использовали запрос на получение товара. Слово query там не написано, потому что для некоторых простых запросов его разрешено опускать.

Mutation — изменение данных

Mutation нужна, когда приложение должно выполнить действие, изменяющее информацию.

Например, создать заказ, обновить профиль или отправить новое обращение в поддержку. Какие действия доступны, зависит от конкретного GraphQL API.

Для создания заявки обычно недостаточно просто отправить произвольные данные. Сервер проверяет запрос и права пользователя, а затем выполняет предусмотренную операцию.

Subscription — получение обновлений

Subscription позволяет приложению получать новые данные при наступлении определённых событий.

Например, чат может показывать новые сообщения без ручного обновления страницы. Другой вариант — отображение изменений статуса заказа, если сервис поддерживает такую возможность.

Подписки есть не в каждом GraphQL API. Для многих сайтов достаточно обычных запросов на чтение и изменение данных.

Где GraphQL используют на практике

GraphQL применяется в реальных сервисах, с которыми работают интернет-магазины, владельцы сайтов и маркетологи. Рассмотрим два подтверждённых примера и одну возможную задачу для партнёрской сети.

Shopify: товары, цены и заказы

В Shopify используют GraphQL API для работы с данными интернет-магазинов. Через Storefront API можно получать сведения о товарах, вариантах, изображениях и ценах.

Это помогает создавать собственные витрины магазинов. Например, на главной странице показывать подборку товаров с фотографиями и ценами, а на подробной — дополнительные характеристики и варианты покупки.

Для управления магазином Shopify предоставляет отдельный GraphQL Admin API. Через него приложения могут выполнять разрешённые административные операции, но для работы с реальными данными потребуются соответствующие права доступа.

Интерфейс GraphiQL с запросом списка товаров Shopify и ответом API, содержащим названия и идентификаторы продуктов.
Пример GraphQL-запроса к каталогу Shopify: разработчик выбирает нужные сведения о товарах и получает структурированный ответ.

Cloudflare: статистика сайта

Cloudflare использует GraphQL для аналитики сетевых запросов. Через GraphQL Analytics API можно получать статистику HTTP-запросов, событий защиты и некоторых других продуктов компании.

Например, владелец сайта может запросить сведения о количестве обращений к ресурсу за выбранный период. Также API позволяет выбирать показатели, задавать фильтры и группировать данные.

Для вебмастера это может быть полезно при создании собственного отчёта или панели мониторинга. При этом Cloudflare анализирует сетевой трафик, а не результативность рекламных кампаний: одобренные лиды и выплаты партнёрки нужно учитывать отдельно.

Редактор GraphiQL в руководстве Cloudflare с запросом событий межсетевого экрана и выбором полей action, datetime и userAgent.
Cloudflare показывает, как через GraphQL выбрать события защиты сайта и необходимые поля статистики.

Партнёрская сеть: данные для личного кабинета

Допустим, CPA-сеть разрабатывает новый кабинет вебмастера. На главном экране нужно показать баланс, последние заявки и доход за сегодня. На странице статистики — уже подробные данные по офферам и источникам трафика.

GraphQL можно использовать, чтобы каждый экран запрашивал подходящий набор сведений. Разработчики при этом должны заранее описать доступные данные и настроить права пользователей.

Это пример возможного применения, а не утверждение, что конкретная партнёрская сеть использует GraphQL. Схожую задачу можно решить и через REST API.

★ Где этому научиться

Курс «Полный путь web-разработчика» в Академии IT DMS

✓HTML, CSS, Flexbox, Grid и Tailwind CSS
✓JavaScript от основ до async/await, Git и GitHub
✓Backend на Node.js, базы данных и проекты на React и Next.js

Сертификат, диплом о переподготовке или удостоверение о повышении квалификации.

Перейти к курсу →ПромокодAFFTIMES

−5 % на первую покупку. Скидка суммируется с любыми акциями школы. Если оплачиваете через менеджера в чате, назовите ему промокод.

Как попробовать GraphQL без программирования

Для знакомства с GraphQL есть официальный интерактивный редактор GraphiQL с демонстрационным API Star Wars.

Он использует сведения о персонажах, планетах и фильмах из вселенной «Звёздных войн». Можно отправить запрос и посмотреть, какие данные вернёт сервер, без создания собственного сайта или установки программ.

Откройте редактор

Перейдите на страницу демонстрации. На ней должен открыться GraphiQL — интерфейс для отправки GraphQL-запросов.

В редакторе есть область для текста запроса и область, где показывается ответ. Для выполнения запроса используется кнопка запуска, обычно со значком треугольника.

Получите сведения о персонажах

Удалите содержимое поля запроса, если там уже есть пример, и вставьте:

{

  allPeople(first: 2) {

    people {

      name

      birthYear

    }

  }

}

Нажмите кнопку запуска.

В этом запросе allPeople означает список персонажей. Параметр first: 2 ограничивает его двумя записями, а поля name и birthYear запрашивают имена и годы рождения.

Ответ появится в формате JSON. Это способ записи данных, в котором названия полей связаны с их значениями. Необязательно разбираться во всех скобках — посмотрите, что у каждого персонажа есть только те сведения, которые мы указали.

Измените запрос

Теперь удалите строку birthYear и снова запустите запрос.

Сервер должен вернуть имена без годов рождения. Затем можно заменить birthYear на eyeColor, чтобы посмотреть, какого цвета глаза у персонажей.

Попробуйте также изменить first: 2 на first: 3. Тогда запрос будет запрашивать уже три записи.

Вы самостоятельно изменили состав и количество данных, которые получает приложение. Для этого не понадобилось писать программу или настраивать сервер.

Если захотите подробнее рассмотреть JSON-ответ, воспользуйтесь форматтером JSON на AffTimes. Он расставляет отступы и помогает читать вложенные данные.

Демонстрационный сервис может быть временно недоступен. Сам пример запроса основан на опубликованной схеме SWAPI GraphQL; при проблемах с загрузкой редактора можно посмотреть официальный проект на GitHub.

Что такое GraphiQL и где найти документацию

GraphiQL — это инструмент для работы с GraphQL API прямо в браузере. Он помогает составлять запросы, изучать доступные поля и просматривать ответы сервера.

В ноябре 2026 года вышла новая версия GraphiQL 6. В ней появился встроенный конструктор запросов: поля можно выбирать из схемы, не набирая всё вручную. Также разработчики добавили более удобные способы просмотра результатов, включая таблицы и раскрывающиеся структуры данных.

Это особенно полезно новичку. Вместо того чтобы сразу писать сложный запрос, можно изучить доступные поля и постепенно собрать нужную операцию.

Основные материалы по технологии собраны в официальной документации GraphQL. Она доступна на английском языке, а для первого знакомства можно использовать перевод страниц в браузере.

При поиске документации на русском важно учитывать, что разные сервисы используют собственные схемы. Запрос к Shopify не обязательно подойдёт для Cloudflare или другого GraphQL API. Общий принцип один, но доступные поля, условия подключения и правила работы определяет владелец сервиса.

Преимущества и недостатки GraphQL

Главное преимущество GraphQL — возможность запрашивать информацию под конкретную задачу. Это удобно для приложений, где разные страницы используют различные сочетания данных.

Например, мобильной версии сервиса достаточно показать пять последних заказов, а на полноценной странице истории покупок нужны фильтры, подробности и дополнительные сведения. При правильно устроенном GraphQL API разработчики могут составить для каждого экрана собственный запрос.

Но у этой гибкости есть ограничения, которые важно учитывать при разработке.

  • Сложные запросы могут нагружать сервер. Если приложение запрашивает слишком много связанных данных, обработка потребует дополнительных ресурсов.
  • Нужно настраивать права доступа. Возможность указать поле в запросе не должна означать разрешение читать любые сведения.
  • Не все задачи выигрывают от GraphQL. Для небольшого API с несколькими простыми операциями REST может быть легче в разработке и поддержке.
  • Понадобится контролировать запросы. В рабочих сервисах могут ограничивать их сложность, размер результатов и частоту обращений.

Например, если через API можно получить сведения о заказах, сервер обязан следить, чтобы пользователь не увидел покупки другого человека. GraphQL предоставляет способ запрашивать данные, но не заменяет проверку прав и другие меры защиты.

Разработчики также оценивают, насколько удобно будет поддерживать API, добавлять новые функции и отслеживать ошибки. Для больших продуктов это не менее важно, чем гибкость запросов.

GraphQL стоит рассматривать, когда у сайта или приложения много взаимосвязанных данных, а потребности разных экранов заметно отличаются. Если задача сводится к нескольким простым обращениям к серверу, начинать с GraphQL необязательно.

FAQ

Что такое GraphQL простыми словами?

GraphQL — язык запросов к API, который позволяет приложению выбирать доступные поля и получать соответствующие данные с сервера.

Для чего нужен GraphQL?

GraphQL используют для обмена данными между приложением и сервером. Например, для получения товаров, заказов, статистики и сведений о пользователях.

Чем GraphQL отличается от REST API?

В REST приложение обычно обращается к адресам ресурсов, а в GraphQL составляет запрос из нужных полей. При подходящей схеме GraphQL позволяет получить связанные данные одной операцией.

Что такое Query в GraphQL?

Query — операция для чтения данных. Через неё можно запросить, например, название товара, сведения об аккаунте или статистику сервиса.

Что такое Mutation в GraphQL?

Mutation — операция для выполнения действий, которые могут изменять данные: создания заказа, обновления профиля или отправки обращения.

Что такое Subscription в GraphQL?

Subscription — операция для получения обновлений при определённых событиях. Например, её можно использовать в приложении для отображения новых сообщений.

GraphQL быстрее REST?

Не обязательно. GraphQL может сократить объём лишних данных и количество обращений к серверу, но скорость зависит от сложности запроса и настройки API.

Где попробовать GraphQL без программирования?

Для знакомства подойдёт официальный демонстрационный редактор GraphiQL на graphql.org/swapi-graphql. В нём можно отправлять запросы и просматривать ответы сервера.

Где найти документацию GraphQL на русском?

Основная документация размещена на graphql.org и написана на английском. Для чтения можно использовать перевод браузера. Русскоязычные учебные материалы также доступны на сторонних ресурсах.

Валерия Шлегель
Валерия Шлегель
Автор
(Проголосовать за статью)

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

X