Что такое GraphQL?
GraphQL — это открытый язык запросов (query language) и среда выполнения для получения и изменения данных через API. Facebook создала его в 2012 году для своего мобильного приложения, а в 2015 году открыла как проект с открытым исходным кодом. С 2018 года GraphQL развивает независимая организация GraphQL Foundation в составе Linux Foundation.
GraphQL — гибкая альтернатива традиционному подходу REST API. Его главное преимущество: клиент запрашивает только нужные ему данные и получает именно их — не больше и не меньше.
Аналогия из реальной жизни
- REST API похож на заказ готового комплексного обеда в ресторане: вы просите «сет №1» и получаете всё, что в него входит, — даже если салат вам не нужен.
- GraphQL — это заказ «à la carte»: вы точно говорите официанту, что хотите суп, хлеб и чай, — и получаете только это.
Какие проблемы решает GraphQL?
При работе с REST API часто возникают две типичные проблемы:
- Over-fetching (лишние данные): сервер возвращает больше данных, чем нужно. Например, вам нужно только имя пользователя, а API присылает весь профиль — адрес, дату рождения и десятки других полей.
- Under-fetching (недостаток данных): одного запроса не хватает, и для сбора нужных данных приходится отправлять несколько. Например, сначала получить пользователя, потом его посты, а затем отдельными запросами — комментарии к каждому посту.
GraphQL решает обе проблемы: одним запросом можно получить ровно то, что нужно. Это особенно важно для мобильных приложений, ведь каждый лишний запрос влияет на трафик и задержку.
Основные особенности
- Точные запросы: вы сами определяете, какие поля нужны. Например, можно запросить у пользователя только имя и email — остальные поля не придут.
- Связанные данные в одном запросе: пользователя, его посты и комментарии можно получить одним запросом.
- Один endpoint: в REST есть разные адреса вроде /users и /posts. В GraphQL же все запросы обычно отправляются на один адрес — например, /graphql.
- Система типов и схема: в GraphQL структура каждого объекта и типы его полей заранее точно описаны в схеме (schema). Она служит понятным «договором» и для клиента, и для сервера и предотвращает множество ошибок. Подробнее о типах — на странице о типах данных.
Пример запроса
Допустим, нужно получить имя, email пользователя с ID 1 и заголовки его постов. В REST для этого может понадобиться несколько запросов. В GraphQL же достаточно одного: в запросе указывается объект user(id: 1), внутри него — поля name и email, а также объект posts с полем title. Сервер возвращает ответ в той же форме, что и запрос, — обычно в формате JSON.
Три вида операций
- Query (запрос): для чтения данных. Например, получить список товаров.
- Mutation (изменение): для создания, изменения или удаления данных. Например, добавить новый комментарий.
- Subscription (подписка): для получения обновлений в реальном времени. Например, сразу узнавать о новом сообщении в чате.
Как работает GraphQL?
На стороне сервера для каждого поля пишется функция — резолвер (resolver). Резолвер знает, откуда и как получить данные этого поля: из базы данных, другого API или файла. Когда приходит запрос, GraphQL вызывает нужные резолверы и объединяет результаты в один ответ.
GraphQL и SQL: в чём разница?
Хотя в названии есть «QL» — Query Language, GraphQL — не язык запросов к базе данных.
- SQL напрямую общается с базой данных.
- GraphQL работает на уровне API — между клиентом и сервером.
За сервером GraphQL может стоять любая база данных — SQL или NoSQL — или вообще другие сервисы.
Недостатки
- Сложности с кешированием: в REST у каждого ресурса свой адрес, поэтому браузеры и серверы легко кешируют ответы. В GraphQL все запросы идут на один адрес, и это сложнее.
- Сложность: для маленьких и простых проектов GraphQL может быть избыточен — REST проще и быстрее настраивается.
- Проблема N+1: без оптимизации один запрос может вызвать в фоне десятки и даже сотни дополнительных запросов к базе данных.
- Безопасность: поскольку клиент сам пишет запросы, очень глубокие и тяжёлые запросы могут перегрузить сервер. Поэтому глубину и сложность запросов нужно ограничивать.
Где используется?
- В мобильных приложениях — чтобы уменьшить трафик и количество запросов;
- В сложных веб-приложениях и SPA — для интерфейсов с множеством связанных данных;
- В крупных компаниях — например, GitHub и Shopify предоставляют свои публичные API на GraphQL.
GraphQL широко применяется в современной веб-разработке, чтобы сделать обмен данными между frontend и backend более точным и эффективным. Но это не «смерть» REST: у обоих подходов свои преимущества, и выбор зависит от потребностей проекта.
Хотите применить эти знания на практике и получить реальные результаты? Начните обучение на курсе «IT и Компьютерная инженерия» и шаг за шагом приобретайте практические навыки. Подробнее о курсе — перейдите по ссылке: Курс «IT и Компьютерная инженерия».

