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

GraphQL: архитектура и различия с REST

Что такое GraphQL

GraphQL — это язык запросов и runtime для APIs (Application Programming Interfaces), разработанный компанией Facebook в 2015 году. Это открытый стандарт, который позволяет клиентам запрашивать ровно те данные, которые им нужны, и получать их в точно таком формате, в каком они были запрошены.

GraphQL работает с единственной точкой входа (endpoint) и предоставляет мощный язык для описания структуры данных и операций над ними.

Ключевые различия между GraphQL и REST

1. Архитектура и концепция

REST (Representational State Transfer):

• Использует множество endpoint'ов для различных ресурсов (/users, /posts, /comments)
• Операции завязаны на HTTP методы (GET, POST, PUT, DELETE)
• Каждый endpoint возвращает полный набор данных

GraphQL:

• Использует один endpoint
• Определяет операции через язык запросов (Query, Mutation, Subscription)
• Клиент явно указывает, какие поля нужны

2. Запрос данных (Over-fetching и Under-fetching)

REST проблема — Over-fetching: GET /api/users/123 возвращает все поля: id, name, email, phone, address, created_at, role. Но клиенту могут быть нужны только name и email.

REST проблема — Under-fetching: Сначала запрашиваем юзера (GET /api/users/123), потом посты юзера (GET /api/posts?user_id=123), потом комментарии к постам (GET /api/comments). Результат: 3+ HTTP запроса вместо одного.

GraphQL решение: Один запрос с явным указанием нужных полей, включая вложенные данные.

3. Версионирование API

REST:

• Требует версионирования: /api/v1/, /api/v2/
• Старые версии нужно поддерживать долго
• При изменении структуры — нужна новая версия

GraphQL:

• Самовержионирующийся благодаря сильной типизации
• Клиент запрашивает только нужные поля
• Можно добавлять новые поля без breaking changes

4. Типизация и самодокументирование

REST:

• Требует отдельной документации (Swagger, OpenAPI)
• Типы данных не явны в самом API

GraphQL:

• Строгая типизация встроена в язык
• Автоматическая документация (Introspection)
• IDE может предоставить автодополнение

5. Производительность

REST:

• Меньше запросов обычно означает больше данных в ответе
• Кэширование просто (по URL)

GraphQL:

• Точнее контроль над объёмом данных
• Кэширование сложнее (т.к. это POST запросы)
• Возможен N+1 problem на сервере

Когда использовать

Выбирай REST если:

• Простой CRUD API с чёткой структурой ресурсов
• Нужна максимальная производительность с кэшированием
• Команда привыкла к REST паттернам

Выбирай GraphQL если:

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