REST (Representational State Transfer) – архитектурный стиль взаимодействия распределённых систем, описанный Роем Филдингом в диссертации 2000 года. В REST-API каждая сущность – ресурс со своим адресом (URL), а операции над ним выполняются стандартными методами HTTP. Сегодня это самый распространённый способ интеграции веб-сервисов и приложений.
Основные принципы
- Клиент-серверная архитектура и отсутствие состояния: каждый запрос содержит всё необходимое.
- Единый интерфейс: GET – получить, POST – создать, PUT/PATCH – изменить, DELETE – удалить.
- Кешируемость ответов.
- Многоуровневая система: между клиентом и сервером могут быть шлюзы и прокси.
Как выглядит на практике
Данные обычно передаются в JSON, результат сообщается кодами HTTP (200, 201, 404, 422 и т. д.). Описание API часто публикуется в формате OpenAPI (Swagger), по которому генерируются документация и клиентские библиотеки.
Что важно при интеграции
- Наличие документации OpenAPI и тестовой среды.
- Аутентификация: ключи API, OAuth 2.0, токены.
- Ограничения на частоту запросов и постраничная выдача.
- Версионирование API и политика обратной совместимости.
