REST-api в действии: Практические примеры и реальные проекты. Разработчик

(Uniform Resource Locator) – это специальный тип URI, который используется для указания местоположения ресурса в сети. содержит информацию о том, где находится ресурс, и как к нему можно получить доступ. обычно начинается с протокола (например, `http` или `https`), за которым следует имя хоста путь ресурсу.

      Например, следующий URL: `https://example.com/users/123` является также URI, но он содержит дополнительную информацию о том, как получить доступ к ресурсу.

      Разница между URI и URL

      Основная разница между URI и URL заключается в том, что – это более широкое понятие, которое может включать не только местоположение ресурса, но его имя или идентификатор. URL, наоборот, всегда указывает на ресурса.

      Например, следующий 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, форм-данные и многое другое.

      Например, если мы хотим