REST API

#7.1 Принципы REST

REST (Representational State Transfer) — архитектурный стиль для проектирования API. RESTful API использует HTTP-методы для операций над ресурсами, идентифицируемыми URL-адресами.

Ключевые принципы REST:

• Ресурсы — всё является ресурсом (пользователь, пост, заказ). URL идентифицирует ресурс
• HTTP-методы — определяют действие: GET (чтение), POST (создание), PUT/PATCH (обновление), DELETE (удаление)
• Stateless — сервер не хранит состояние клиента между запросами. Каждый запрос содержит всю необходимую информацию
• Единый интерфейс — предсказуемые URL, стандартные методы, JSON-формат
• Статус-коды — результат операции передаётся через HTTP-код (200, 201, 404, 500)

REST — не протокол, а набор договорённостей, благодаря которым API предсказуем. Главное: всё — ресурс, адресуемый по URL; действие задаётся HTTP-методом, а не URL; сервер не хранит состояние клиента между запросами (stateless). Отсутствие состояния важно для масштабирования: поскольку каждый запрос самодостаточен (несёт всё необходимое, включая токен авторизации — с ним познакомимся в модуле 8), его может обслужить любой из множества серверов.