Например, следующий URI: `urn:isbn:0-486-27557-4` является идентификатором книги, но он не содержит информации о том, где находится книга. Этот URI URL, поскольку указывает на местоположение ресурса.
Использование URI и URL в REST-api
В REST-api URI и URL используются для обозначения ресурсов операций над ними. Например, если мы хотим получить список всех пользователей, можем использовать следующий URI: `https://example.com/users`. Если информацию о конкретном пользователе, `https://example.com/users/123`.
В этом случае URI `https://example.com/users` является коллекцией ресурсов, а `https://example.com/users/123` отдельным ресурсом.
Вывод
В этой главе мы рассмотрели понятия URI и URL, как они используются в REST-api. Мы увидели, что – это более широкое понятие, которое может включать не только местоположение ресурса, но его имя или идентификатор. наоборот, всегда указывает на ресурса. Понимание этих понятий важно для разработки REST-api, поскольку обозначения ресурсов операций над ними. следующей рассмотрим, использовать HTTP-методы выполнения ресурсами.
2.3. Заголовки и тело запроса
Когда мы уже знаем, как создавать запросы к REST-api, пришло время поговорить о двух важных аспектах: заголовках и теле запроса. Эти два элемента играют ключевую роль в передаче данных между клиентом сервером, их правильное использование может существенно повлиять на эффективность безопасность нашего api.
Заголовки
Заголовки (headers) – это ключ-значение пары, которые передаются вместе с запросом или ответом. Они содержат мета-информацию о запросе ответе, такую как тип содержимого, кодировка, авторизация и многое другое. могут быть использованы для передачи дополнительной информации, которая не входит в состав тела запроса ответа.
Например, если мы хотим отправить запрос на сервер с данными в формате JSON, можем использовать заголовок `Content-Type` значением `application/json`. Это позволит серверу правильно интерпретировать данные и обработать их соответствующим образом.
```http
GET /users HTTP/1.1
Host: example.com
Content-Type: application/json
Authorization: Bearer token
```
В этом примере мы используем заголовок `Content-Type` для указания типа содержимого, а также `Authorization` передачи токена авторизации.
Тело запроса
Тело запроса (body) – это часть запроса, которая содержит фактические данные, которые мы хотим отправить на сервер. может быть использовано для передачи данных в различных форматах, таких как JSON, XML, форм-данные и многое другое.