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

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

Это три различных архитектурных подхода для создания веб-сервисов и API. Каждый имеет свои преимущества, недостатки и область применения.

REST — простота и стандарт

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

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

• Методы: GET, POST, PUT, DELETE, PATCH
• Ресурсы: URL идентифицируют ресурсы (/users/123, /orders/456)
• Состояние: не хранится на сервере (stateless)
• Формат: обычно JSON

Пример REST API:

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class User(BaseModel):
    id: int
    name: str
    email: str

@app.get("/users/{user_id}")
async def get_user(user_id: int) -> User:
    return User(id=user_id, name="John", email="john@example.com")

@app.post("/users")
async def create_user(user: User) -> User:
    return user

@app.put("/users/{user_id}")
async def update_user(user_id: int, user: User) -> User:
    return user

@app.delete("/users/{user_id}")
async def delete_user(user_id: int) -> dict:
    return {"status": "deleted"}

Преимущества REST:

• Простой и интуитивный
• Легко кешировать (HTTP кеш)
• Хорошая поддержка инструментами
• Низкий оверхед
• Идеален для CRUD операций

Недостатки REST:

• Over-fetching: получаешь больше данных, чем нужно
• Under-fetching: нужны несколько запросов
• Версионирование API затруднено
• Сложнее обрабатывать сложные связи данных

SOAP — стандартизация и надежность

SOAP (Simple Object Access Protocol) — это протокол для обмена структурированными данными на основе XML.

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

• Формат: XML
• Синтаксис: использует WSDL для описания
• Транспорт: HTTP, SMTP, другие
• Стандартизация: строгие спецификации

Пример SOAP API:

<!-- Request -->
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap-envelope/">
  <soap:Body>
    <GetUser xmlns="http://example.com/users">
      <userId>123</userId>
    </GetUser>
  </soap:Body>
</soap:Envelope>

<!-- Response -->
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap-envelope/">
  <soap:Body>
    <GetUserResponse xmlns="http://example.com/users">
      <User>
        <id>123</id>
        <name>John</name>
        <email>john@example.com</email>
      </User>
    </GetUserResponse>
  </soap:Body>
</soap:Envelope>

Преимущества SOAP:

• Строго стандартизирован
• Отличная безопасность (WS-Security)
• Надежен для critical операций
• Хорошо подходит для enterprise интеграций
• Встроенная обработка ошибок

Недостатки SOAP:

• Очень сложен (даже для простых задач)
• Большой объём трафика (XML)
• Медленнее REST и GraphQL
• Сложная отладка
• Требует специальных инструментов
• Почти не используется в новых проектах

GraphQL — гибкость и эффективность

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

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

• Язык запросов: специальный синтаксис
• Типизация: строгая типизация schema
• Один endpoint: обычно /graphql
• Форматы: JSON

Пример GraphQL API:

import strawberry
from typing import List

@strawberry.type
class User:
    id: int
    name: str
    email: str

@strawberry.type
class Query:
    @strawberry.field
    def user(self, user_id: int) -> User:
        return User(id=user_id, name="John", email="john@example.com")
    
    @strawberry.field
    def users(self) -> List[User]:
        return [User(id=1, name="John", email="john@example.com")]

schema = strawberry.Schema(query=Query)

Запрос GraphQL:

query {
  user(userId: 123) {
    id
    name
  }
}

Ответ:

{
  "data": {
    "user": {
      "id": 123,
      "name": "John"
    }
  }
}

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

• Точное получение данных: только нужные поля
• Один endpoint: все запросы через /graphql
• Сильная типизация: schema определяет структуру
• Self-documenting: инструменты автогенерируют документацию
• Powerful разработка: GraphQL Playground, Apollo DevTools
• Версионирование: не нужно версионировать, просто добавляй поля
• Отличное для mobile: уменьшается трафик

Недостатки GraphQL:

• Сложнее изучить
• Сложнее кешировать (один endpoint, POST запросы)
• Могут быть проблемы с производительностью при неправильных запросах
• Нужен опытный разработчик
• Требует изменения архитектуры backend

Сравнение в таблице

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

Используй REST когда:

• Простые CRUD операции
• Нужен хороший кеш
• Быстрый старт проекта
• Нужна максимальная производительность
• Публичный API

Используй SOAP когда:

• Legacy системы требуют интеграции
• Критична надежность (банки, страховка)
• Нужна максимальная безопасность
• Enterprise интеграции

Используй GraphQL когда:

• Много разных клиентов с разными потребностями в данных
• Mobile приложения (нужно экономить трафик)
• Сложные связи между данными
• Часто добавляются новые поля
• Нужна сильная типизация

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