Введение и проблематика

REST (Representational State Transfer) — это архитектурный стиль для построения распределённых систем, предложенный Роем Филдингом в 2000 году в его докторской диссертации. REST определяет набор ограничений, которые делают веб-сервисы масштабируемыми, надёжными и простыми для понимания.

Какую проблему решает REST?

До появления REST веб-сервисы строились по разным принципам, что приводило к проблемам:

• Сложность интеграции — каждый сервис имел уникальный интерфейс
• Низкая масштабируемость — серверы хранили состояние клиентов
• Отсутствие стандартов — разработчикам приходилось изучать каждый API с нуля

REST предложил унифицированный подход, основанный на уже существующих стандартах HTTP.

Базовая теория

Ресурсы — основа REST

В REST всё является ресурсом. Ресурс — это любая именованная сущность: пользователь, товар, заказ, статья. Каждый ресурс идентифицируется уникальным URI (Uniform Resource Identifier).

/users           — коллекция пользователей
/users/123       — конкретный пользователь с id=123
/users/123/orders — заказы пользователя 123
/products        — коллекция товаров
/products/456    — конкретный товар

6 ограничений REST

REST определяет шесть архитектурных ограничений:

HTTP-методы в REST

REST использует стандартные HTTP-методы для операций над ресурсами:

Идемпотентность — повторный запрос даёт тот же результат. Безопасность — запрос не изменяет состояние сервера.

Практические примеры

CRUD операции через REST API

GET /api/users HTTP/1.1
Host: example.com
Authorization: Bearer token123

{
  "data": [
    { "id": 1, "name": "Иван", "email": "ivan@mail.ru" },
    { "id": 2, "name": "Мария", "email": "maria@mail.ru" }
  ],
  "total": 2
}

POST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json
Authorization: Bearer token123
 
{
  "name": "Алексей",
  "email": "alexey@mail.ru"
}

{
  "id": 3,
  "name": "Алексей",
  "email": "alexey@mail.ru"
}

PUT /api/users/3 HTTP/1.1
Host: example.com
Content-Type: application/json
 
{
  "name": "Алексей Петров",
  "email": "alexey.petrov@mail.ru"
}

{
  "id": 3,
  "name": "Алексей Петров",
  "email": "alexey.petrov@mail.ru"
}

DELETE /api/users/3 HTTP/1.1
Host: example.com
Authorization: Bearer token123

Пример на JavaScript (fetch)

// Получение списка пользователей
const response = await fetch('/api/users', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer token123'
  }
});
 
const users = await response.json();
console.log(users);

Пограничные кейсы

❌ GET  /getUsers
❌ POST /createUser
❌ POST /deleteUser/123

✅ GET    /users
✅ POST   /users
✅ DELETE /users/123

Действие определяется HTTP-методом, а не URL.

// ❌ Неправильно — всегда 200, ошибка в теле
{
  "status": 200,
  "success": false,
  "error": "User not found"
}
 
// ✅ Правильно — используем HTTP статус-коды
// 404 Not Found
{
  "error": "User not found"
}

Основные HTTP статус-коды

Продвинутые аспекты

Richardson Maturity Model

Модель зрелости REST API по Леонарду Ричардсону:

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

GET /api/v1/users
GET /api/v2/users

Плюсы и минусы

REST vs GraphQL vs gRPC

Вопросы интервьюера

Q: Что такое REST и чем он отличается от SOAP?

REST — архитектурный стиль, SOAP — протокол. REST использует стандартный HTTP, легче и гибче. SOAP требует XML и имеет строгую спецификацию (WSDL).

Q: Что означает Stateless в REST?

Сервер не хранит состояние клиента между запросами. Каждый запрос должен содержать всю информацию для обработки (токен, параметры). Это позволяет легко масштабировать систему.

Q: В чём разница между PUT и PATCH?

PUT заменяет ресурс целиком (нужно передать все поля), PATCH обновляет только указанные поля. PUT идемпотентен, PATCH — нет.

Q: Что такое идемпотентность?

Свойство операции давать одинаковый результат при многократном выполнении. GET, PUT, DELETE — идемпотентны. POST — нет (каждый вызов создаёт новый ресурс).

Q: Как обрабатывать ошибки в REST API?

Использовать соответствующие HTTP статус-коды (400, 401, 404, 500) и возвращать структурированное тело ошибки с описанием проблемы.

Источники

• Диссертация Роя Филдинга (оригинал REST)
• MDN: HTTP
• RESTful API Design Guide
• Richardson Maturity Model
• HTTP Status Codes