Вкратце о REST

REST — это архитектурный подход для построения веб-сервисов, основанный на использовании стандартных HTTP-методов для работы с ресурсами. Подробнее с ним мы познакомимся в соответствующей теме, но некоторые основы стоит показать сейчас:

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

  • Ресурсы — сущности, которые можно запросить: /users, /tasks, /products
  • Методы HTTP — действия над ресурсами:
    • GET — получить список или один элемент
    • POST — создать новый ресурс
    • PUT / PATCH — обновить существующий
    • DELETE — удалить ресурс
  • Состояние — сервер не хранит сессию клиента (stateless). Каждый запрос должен содержать всё необходимое для обработки (например, токен авторизации в заголовке).

Пример запросов:

GET    /api/users       → список пользователей
POST   /api/users       → создать нового пользователя
GET    /api/users/123   → получить пользователя с id=123
PUT    /api/users/123   → обновить данные пользователя 123
DELETE /api/users/123   → удалить пользователя 123

Ответы приходят в формате JSON — структурированные данные, которые легко читает клиент (веб или мобильное приложение).