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

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

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

REST (Representational State Transfer)

REST — архитектурный стиль, основанный на стандартных HTTP методах и ресурсах.

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

• Фиксированные endpoint'ы: /api/users, /api/users/123, /api/posts
• HTTP методы: GET (чтение), POST (создание), PUT (обновление), DELETE (удаление)
• Multiple requests: для получения связанных данных нужны отдельные запросы
• Over-fetching: получаешь больше данных, чем нужно
• Under-fetching: если нужны связанные данные, нужны дополнительные запросы

// REST: несколько запросов для получения пользователя и его постов
var user = await client.get('/api/users/123');
var posts = await client.get('/api/users/123/posts');
var comments = await client.get('/api/posts/456/comments');

// Проблема: 3 запроса вместо одного

GraphQL

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

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

• Один endpoint: /graphql
• Гибкие запросы: запрашиваешь нужные поля
• Граф данных: можно запросить связанные данные одним запросом
• Strongly typed: схема определяет типы и доступные поля
• Introspection: автоматическая документация

// GraphQL: один запрос для получения всего
var query = '''{
  user(id: "123") {
    id
    name
    email
    posts {
      id
      title
      comments {
        id
        text
      }
    }
  }
}''';

var response = await client.post(
  Uri.parse('https://api.example.com/graphql'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({'query': query}),
);

Сравнение

Проблемы REST

1. Over-fetching: получаешь ненужные поля

// Нужно только имя и email, но получишь всё
GET /api/users/123
// Ответ: {id, name, email, phone, address, birthDate, ...}

2. Under-fetching: нужны дополнительные запросы

GET /api/users/123          // Получить пользователя
GET /api/users/123/posts    // Получить его посты
GET /api/posts/456/comments // Получить комментарии
// Итого: 3 запроса

Преимущества GraphQL

1. Точность данных: запрашиваешь ровно что нужно

query {
  user(id: "123") {
    name
    email
  }
}
// Ответ: {name: "John", email: "john@example.com"}

2. Один запрос для сложных данных

query {
  user(id: "123") {
    name
    posts {
      title
      comments {
        text
        author {
          name
        }
      }
    }
  }
}

3. Автоматическая документация

// GraphQL Playground / Apollo Studio
// Идеальная документация из схемы
type User {
  id: ID!
  name: String!
  email: String!
  posts: [Post!]!
}

type Post {
  id: ID!
  title: String!
  comments: [Comment!]!
}

Недостатки GraphQL

• Кэширование сложнее: нет встроенного HTTP кэша
• Размер запроса: GraphQL запрос может быть больше REST
• Защита: нужна защита от слишком сложных запросов (N+1 problem)
• Обучение: команда должна изучить GraphQL

Практический пример в Flutter

С GraphQL пакетом:

import 'package:graphql_flutter/graphql_flutter.dart';

class UserService {
  late GraphQLClient _client;
  
  UserService() {
    _client = GraphQLClient(
      link: HttpLink('https://api.example.com/graphql'),
      cache: GraphQLCache(),
    );
  }
  
  Future<User> getUser(String id) async {
    final query = gql('''
      query GetUser(\$id: ID!) {
        user(id: \$id) {
          id
          name
          email
          posts {
            id
            title
          }
        }
      }
    ''');
    
    final result = await _client.query(
      QueryOptions(
        document: query,
        variables: {'id': id},
      ),
    );
    
    if (result.hasException) {
      throw Exception('Failed to fetch user');
    }
    
    return User.fromJson(result.data!['user']);
  }
}

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

REST:

• Простые API
• Хорошее кэширование важно
• Стартапы с малой командой
• Публичные API

GraphQL:

• Сложные связанные данные
• Мобильные приложения (экономия трафика)
• Быстрое прототипирование
• Большие команды

Вывод

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