пользователей.
| Метод URI Описание
| –
| GET `/users` Получить список всех пользователей
| POST `/users` Создать нового пользователя
| GET `/users/{id}` Получить информацию о пользователе с заданным id
| PUT `/users/{id}` Обновить информацию о пользователе с заданным id
| DELETE `/users/{id}` Удалить пользователя с заданным id
В этом примере мы используем методы HTTP для манипуляции ресурсами на сервере. Мы можем создавать, читать, обновлять и удалять пользователей, используя соответствующие HTTP.
Вывод
В этой главе мы рассмотрели методы HTTP и их использование в REST-api. Мы увидели, как используются для манипуляции ресурсами на сервере они могут быть использованы создания эффективных систем основе клиент-серверной архитектуры. следующей рассмотрим вопросы безопасности аутентификации
2.2. Структура URL и маршрутизация в REST-api
В предыдущей главе мы рассмотрели основные принципы построения REST-api и их роль в клиент-серверной архитектуре. Теперь давайте более подробно остановимся на структуре URL маршрутизации REST-api, поскольку эти аспекты являются фундаментальными для создания эффективных масштабируемых систем.
Введение в структуру URL
URL (Uniform Resource Locator) – это адрес, по которому клиент может получить доступ к ресурсам на сервере. В REST-api играет ключевую роль в идентификации ресурсов и действий, которые можно с ними выполнить. Структура обычно состоит из следующих частей:
Протокол: указывает на протокол, используемый для передачи данных (например, HTTP или HTTPS).
Домен: имя домена или IP-адрес сервера, на котором расположен ресурс.
Путь: путь к ресурсу на сервере, который может включать несколько сегментов, разделенных символом "/".
Параметры: дополнительные параметры, которые передаются с запросом, обычно в виде пар ключ-значение.
Маршрутизация в REST-api
Маршрутизация – это процесс определения того, какая часть приложения должна обрабатывать входящий запрос. В REST-api маршрутизация обычно основана на структуре URL и методе HTTP, используемом в запросе. Например, если клиент отправляет GET-запрос `/users/123`, сервер может маршрутизировать этот запрос к контроллеру, который обрабатывает запросы получение информации о пользователях.
Основные принципы маршрутизации
При проектировании маршрутизации в REST-api следует учитывать следующие основные принципы:
Ресурс-ориентированность: каждый URL должен идентифицировать конкретный ресурс или коллекцию ресурсов.
Метод-ориентированность: каждый метод HTTP (GET, POST, PUT, DELETE и т.д.) должен соответствовать конкретному действию, которое выполняется над ресурсом.
Краткость: URL должны быть краткими и легко читаемыми, чтобы упростить их использование понимание.
Примеры маршрутизации
Давайте рассмотрим несколько примеров маршрутизации в REST-api:
GET /users: возвращает список всех пользователей.
GET /users/123: возвращает информацию о пользователе