В чем разница между REST API и GraphQL?

Разница между REST API и GraphQL

REST API и GraphQL — это два разных подхода к построению интерфейсов обмена данными между клиентом и сервером. Каждый имеет свои преимущества и недостатки.

REST API

REST (Representational State Transfer) — это архитектурный стиль, основанный на стандартных HTTP методах и ресурсах.

Характеристики:

• Ресурс-ориентированный — каждый URL представляет ресурс
• Фиксированная структура — сервер определяет, какие данные вернуть
• Несколько запросов — часто нужно несколько запросов для получения связанных данных
• Кэширование — встроенная поддержка кэширования через HTTP
• Простота — легко понять и реализовать

GET /api/users/123
GET /api/users/123/posts
GET /api/posts/456/comments

{
  "id": "123",
  "name": "John",
  "email": "john@example.com"
}

Проблемы REST:

• Over-fetching — получаешь больше данных, чем нужно
• Under-fetching — нужны дополнительные запросы для связанных данных
• Версионирование — /api/v1/, /api/v2/ для изменения структуры

GraphQL

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

Характеристики:

• Запрос-ориентированный — клиент определяет структуру ответа
• Одна точка входа — обычно один endpoint /graphql
• Сильная типизация — схема GraphQL определяет возможные типы
• Меньше запросов — можно получить всё нужное за один запрос
• Realtime — встроенная поддержка подписок

query {
  user(id: "123") {
    id
    name
    email
    posts(limit: 10) {
      id
      title
    }
  }
}

Сравнение

N+1 проблема

В GraphQL, если не оптимизировать, каждое поле может вызвать отдельный запрос к БД. Решение — DataLoader батчинг:

import DataLoader from 'dataloader';

const userLoader = new DataLoader(async (userIds) => {
  const users = await db.user.findMany({
    where: { id: { in: userIds } }
  });
  return userIds.map(id => users.find(u => u.id === id));
});

const resolvers = {
  Post: {
    author: (post) => userLoader.load(post.authorId)
  }
};

Apollo Server пример

import { ApolloServer, gql } from 'apollo-server-express';

const typeDefs = gql`
  type User {
    id: ID!
    name: String!
    posts: [Post!]!
  }
  
  type Query {
    user(id: ID!): User
  }
`;

const resolvers = {
  Query: {
    user: (_, { id }, context) => 
      context.userService.findById(id)
  }
};

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

REST:

• Простые CRUD операции
• Стандартные веб-приложения
• Максимальное кэширование важно
• Не нужно часто менять структуру

GraphQL:

• Мобильные приложения
• Сложные запросы с вложенными данными
• Частые изменения без версионирования
• Реалтайм приложения со Subscriptions

Проблемы GraphQL

• N+1 проблема — требует DataLoader батчинга
• DoS атаки — сложные запросы могут перегрузить сервер
• Кэширование — нужна дополнительная логика
• Сложнее — требует больше знаний для реализации

Вывод

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