REST: что это и на каких принципах основан?

REST — это архитектурный стиль, разработанный Роем Филдингом, который определяет набор ограничений для создания масштабируемых веб-сервисов.

Основные принципы REST

Клиент-Сервер архитектура

• Разделение ответственности между клиентом и сервером

• Клиент отвечает за пользовательский интерфейс

• Сервер отвечает за хранение данных и бизнес-логику

Stateless (Без состояния)

• Каждый запрос содержит всю необходимую информацию

• Сервер не хранит состояние клиента между запросами

• Сессии хранятся на клиенте (обычно в токенах)

Кэширование

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

• Уменьшает нагрузку на сервер и улучшает производительность

Единообразие интерфейса

• Унифицированный способ взаимодействия с ресурсами

• Использование стандартных HTTP методов

Слоистая система

• Архитектура может состоять из multiple слоев

• Каждый слой знает только о соседних слоях

RESTful практики

Ресурсы и URI

// Хорошие примеры RESTful URI
GET /users          // получить список пользователей
GET /users/123      // получить пользователя с ID 123
POST /users         // создать нового пользователя
PUT /users/123      // обновить пользователя с ID 123
DELETE /users/123   // удалить пользователя с ID 123

HTTP методы

• GET: получение ресурса

• POST: создание нового ресурса

• PUT: полное обновление ресурса

• PATCH: частичное обновление ресурса

• DELETE: удаление ресурса

Коды состояния HTTP

• 200 OK: успешный запрос

• 201 Created: ресурс создан

• 400 Bad Request: ошибка в запросе

• 404 Not Found: ресурс не найден

• 500 Internal Server Error: ошибка сервера

Пример реализации в PHP

class UserController {
    public function index() {
        // GET /users
        $users = User::all();
        return response()->json($users);
    }
    
    public function store(Request $request) {
        // POST /users
        $user = User::create($request->all());
        return response()->json($user, 201);
    }
    
    public function show($id) {
        // GET /users/{id}
        $user = User::findOrFail($id);
        return response()->json($user);
    }
}

Вывод

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