Понятие REST и его принципы (ресурсы, методы HTTP, stateless)
REST – архитектурный стиль веб-сервисов, набор правил для организации взаимодействия в сети.
Ресурсы: каждая сущность (например, пользователь, товар) представляется как ресурс с уникальным URI (обычно URL-адресом).
HTTP-методы: стандартные глаголы HTTP (GET, POST, PUT, DELETE и др.) используются согласно назначению (GET – получить, POST – создать и т.д.) для операций над ресурсами.
Stateless (без сохранения состояния): сервер не хранит состояние клиента между запросами – каждый запрос содержит всю необходимую информацию и обрабатывается изолированно.
Пояснение:
REST (Representational State Transfer) определен Роем Филдингом как архитектурный стиль для распределенных систем. Проще говоря, REST накладывает ряд ограничений и принципов на дизайн API, что делает системы более простыми, масштабируемыми и совместимыми. Ключевая идея – рассматривать данные как ресурсы. Ресурс – это любая сущность, которую можно адресовать. У каждого ресурса свой URI; чаще всего URI оформляются как понятные URL-пути. Например, можно спроектировать ресурс User (пользователь) и дать ему путь /api/users. Тогда конкретный пользователь с ID 123 будет доступен по пути /api/users/123.
Операции RESTful API осуществляются стандартными методами HTTP. Каждый метод несет семантику действия над ресурсом:
GET – получить текущее состояние ресурса (например, GET /api/users/123 возвращает информацию о пользователе 123). Этот метод не изменяет данные на сервере (идемпотентен и безопасен).
POST – создать новый ресурс (например, POST /api/users с телом запроса в виде JSON создает нового пользователя). Успешный ответ обычно 201 Created с указанием URI созданного ресурса.
PUT – заменить состояние ресурса (полное обновление существующего ресурса по URI). Пример: PUT /api/users/123 обновит данные пользователя 123 (при отсутствии может создать).
PATCH – частичное обновление ресурса (изменение некоторых полей).
DELETE – удаление ресурса (DELETE /api/users/123 удалит пользователя 123, обычно возвращается 204 No Content при успехе).
Таким образом, URI + HTTP-метод определяют действие. Желательно использовать имена существительные во множественном числе в пути (например, /users), избегая глаголов, т.к. действие уже выражено методом. Например, для ресурса Product можно спроектировать такие маршруты:
GET /api/products – получить список всех товаров
GET /api/products/{id} – получить товар по идентификатору {id}
POST /api/products – создать новый товар (данные в теле запроса)
PUT /api/products/{id} – полностью обновить товар {id}
PATCH /api/products/{id} – частично обновить товар {id}
DELETE /api/products/{id} – удалить товар {id}
Придерживаясь этих соглашений, API становится RESTful – то есть соответствует принципам REST. Благодаря этому клиенты могут легко понимать и использовать API, а само приложение получает преимущества унифицированного интерфейса.
Отсутствие состояния (Stateless) – важнейший принцип REST. Сервер не сохраняет информации о состоянии клиента между запросами. Каждый запрос самодостаточен: содержит всю необходимую контекстную информацию (например, токен аутентификации, параметры и т.д.) и не зависит от предыдущих вызововrestfulapi.net
. После выполнения запроса сервер не хранит никаких данных о сессии пользователя. Это упрощает масштабирование (любой экземпляр сервера может обслужить запрос, нет “привязки” к сессии) и делает взаимодействие более надежным. Если клиенту нужно сохранить контекст между запросами, он должен сам включать необходимую информацию в каждый новый запрос (например, передавать JWT-токен авторизации при каждом обращении). Stateless-коммуникация также облегчает внедрение кеширования ответов GET и упрощает отладку, так как каждый запрос можно рассматривать отдельно.
Кроме того, REST подразумевает клиенто-серверную модель и единообразие интерфейса. Клиент и сервер четко разделены: клиент отвечает за интерфейс и формирование запросов, сервер – за хранение данных и обработку запросов. Общение идет по стандартному протоколу HTTP. Формат данных, возвращаемых в ответе (представление ресурса), может быть любым, но сегодня чаще всего используется JSON (реже XML). Важно, что статус-коды HTTP тоже являются частью унифицированного интерфейса – сервер должен использовать правильные коды для обозначения результата (об этом подробнее в разделе про статус-коды). В итоге RESTful API – это web-сервис, где URL-адреса обозначают ресурсы, HTTP-методы – действия над ними, а каждый запрос независим от предыдущего. Это простая и мощная модель, ставшая доминирующей для веб-API.