Как расшифровывается REST?

Полная расшифровка и суть REST

REST расшифровывается как Representational State Transfer (Передача Репрезентативного Состояния). Это архитектурный стиль для распределенных систем, впервые описанный Роем Филдингом в его диссертации 2000 года.

Ключевые принципы архитектуры REST

1. Единообразие интерфейса (Uniform Interface)

• Идентификация ресурсов: каждый ресурс имеет уникальный URI
• Манипуляция ресурсами через представления: клиент работает с представлениями ресурсов
• Самодостаточные сообщения: каждый запрос содержит всю информацию для его обработки
• Гипермедиа как двигатель состояния приложения (HATEOAS): клиент взаимодействует через гиперссылки

2. Отсутствие состояния (Stateless)

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

// НЕ RESTful (с состоянием)
session_start();
$_SESSION['user_id'] = 123;
// Сервер "помнит" клиента между запросами

// RESTful (без состояния)
// Каждый запрос содержит токен аутентификации
$requestHeaders = [
    'Authorization: Bearer ' . $accessToken,
    'Content-Type: application/json'
];

3. Кэширование (Cacheable)

Ответы сервера должны явно указывать, можно ли кэшировать данные и как долго.

4. Клиент-серверная архитектура

Четкое разделение ответственности: клиент отвечает за UI и пользовательский опыт, сервер — за хранение данных и бизнес-логику.

5. Многоуровневая система (Layered System)

Между клиентом и сервером могут быть промежуточные слои (прокси, балансировщики нагрузки, кэши).

6. Код по требованию (Code on Demand, опционально)

Сервер может расширять функциональность клиента, передавая исполняемый код.

Практическая реализация в PHP

Пример RESTful API конечной точки

// users.php - обработка ресурса "пользователи"
header('Content-Type: application/json');

// Определение метода запроса
$method = $_SERVER['REQUEST_METHOD'];
$userId = isset($_GET['id']) ? (int)$_GET['id'] : null;

switch ($method) {
    case 'GET':
        if ($userId) {
            // Получить одного пользователя (GET /users/{id})
            echo json_encode(['id' => $userId, 'name' => 'Иван Иванов']);
        } else {
            // Получить всех пользователей (GET /users)
            echo json_encode([
                ['id' => 1, 'name' => 'Иван Иванов'],
                ['id' => 2, 'name' => 'Петр Петров']
            ]);
        }
        break;
        
    case 'POST':
        // Создать нового пользователя (POST /users)
        $input = json_decode(file_get_contents('php://input'), true);
        // Валидация и сохранение данных
        echo json_encode(['id' => 3, 'name' => $input['name']]);
        http_response_code(201); // Created
        break;
        
    case 'PUT':
        // Обновить пользователя (PUT /users/{id})
        $input = json_decode(file_get_contents('php://input'), true);
        echo json_encode(['id' => $userId, 'name' => $input['name']]);
        break;
        
    case 'DELETE':
        // Удалить пользователя (DELETE /users/{id})
        http_response_code(204); // No Content
        break;
        
    default:
        http_response_code(405); // Method Not Allowed
        echo json_encode(['error' => 'Метод не поддерживается']);
}

Использование HTTP методов и кодов состояния

Преимущества REST для Backend-разработки

Гибкость и масштабируемость

• Независимость клиента и сервера
• Легкая поддержка разных типов клиентов (веб, мобильные приложения)

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

• Кэширование снижает нагрузку на сервер
• Статус-коды HTTP помогают в отладке

Простота интеграции

• Стандартные HTTP-методы и коды состояния
• JSON как универсальный формат обмена данными

Распространенные заблуждения о REST

1. REST ≠ JSON API: REST может использовать XML, HTML или другие форматы
2. REST ≠ только HTTP: хотя чаще всего используется с HTTP, принципы применимы к другим протоколам
3. Отсутствие HATEOAS: многие "REST" API на самом деле не полностью соответствуют принципам REST

Заключение

REST — это не протокол, а архитектурный стиль, который использует существующие стандарты HTTP для создания масштабируемых, производительных и поддерживаемых веб-сервисов. Понимание его принципов критически важно для современного backend-разработчика, так как большинство современных API строятся на RESTful-подходе или его вариациях (RESTish API).