Что такое «REST»
Слово ввёл Рой Филдинг, один из авторов спецификации HTTP, в диссертации 2000 года. Он описал, почему веб так хорошо масштабируется, и сформулировал эти свойства как ограничения для архитектуры. Расшифровка — Representational State Transfer, «передача состояния представления»: клиент получает не сам объект, а его представление, например в JSON или HTML, и меняет состояние, отправляя представления обратно. Как эти принципы превращаются в конкретный сервис с адресами и кодами ответов, разобрано в статье про RESTful-веб-сервис.
Шесть ограничений Филдинга
- Клиент — сервер: интерфейс и хранение данных разделены и развиваются независимо.
- Без состояния: каждый запрос несёт всё нужное, сервер не помнит предыдущих.
- Кешируемость: ответ сам говорит, можно ли его сохранить и на сколько.
- Единообразный интерфейс: ресурсы адресуются одинаково, а ответы содержат ссылки на следующие возможные действия.
- Слоистость: между клиентом и сервером могут стоять прокси, балансировщики и CDN, и клиент о них не знает.
- Код по запросу — необязательное: сервер может передать клиенту исполняемый код, например скрипт.
Ресурсы вместо действий
Самое заметное на практике — адрес обозначает существительное, а глагол передаёт метод HTTP:
GET /orders/15 получить заказ
PATCH /orders/15 изменить статус
DELETE /orders/15 отменить заказ
POST /api/deleteOrder?id=15 — стиль действий, не REST
В первом варианте прокси и браузер понимают смысл запроса: GET можно кешировать и повторять, DELETE — нет. Во втором всё выглядит как POST, и инфраструктура ничего не знает о его последствиях.
REST, RPC и SOAP
RPC-подход — это вызов удалённых функций: «выполни getOrderStatus с параметром 15». Так устроены SOAP, JSON-RPC и gRPC. Это не хуже и не лучше, просто другая модель: удобна для операций, которые плохо ложатся на ресурсы, например «пересчитать доставку». Многие API, которые называют себя REST, на деле используют только часть ограничений: JSON поверх HTTP с понятными адресами. Филдинг не раз возражал против такого смешения понятий, но в повседневной речи «REST API» чаще всего означает именно это.
Связанные термины
Обновлено: 10 октября 2026

