Глава 2. Основные концепции REST-api
2.1. Ресурсы и идентификаторы
В предыдущей главе мы познакомились с основными принципами REST-api и их ролью в современных веб-приложениях. Теперь давайте более подробно рассмотрим два фундаментальных понятия, которые лежат основе любого REST-api: ресурсы идентификаторы.
Ресурсы
В контексте REST-api ресурсом называется любая сущность, которая может быть представлена в виде данных. Это пользователь, заказ, продукт, статья или любой другой объект, который имеет значение вашем приложении. Ресурсы могут как простыми, так и сложными, они иметь различные атрибуты свойства.
Например, если мы разрабатываем веб-приложение для онлайн-магазина, то ресурсы могут включать:
Продукты (например, книги, электроника, одежда)
Заказы (например, список товаров, которые пользователь хочет купить)
Пользователи (например, информация о клиентах, их заказах и предпочтениях)
Каждый ресурс имеет уникальный идентификатор, который позволяет нам обращаться к нему и манипулировать им. Идентификаторы будут рассмотрены более подробно в следующем разделе.
Идентификаторы
Идентификатор (или идентификатор ресурса) – это уникальный ключ, который позволяет нам обращаться к ресурсу. Идентификаторы могут быть представлены в виде чисел, строк или комбинации обоих. В REST-api идентификаторы используются для идентификации ресурсов и построения URL-адресов, которые позволяют клиентам ресурсам.
Например, если мы имеем ресурс "продукт" с идентификатором "123", то URL-адрес для обращения к этому ресурсу может выглядеть следующим образом:
`http://example.com/products/123`
В этом примере "123" – это идентификатор ресурса "продукт", а "products" коллекция ресурсов, к которой принадлежит этот продукт.
Типы идентификаторов
Существует несколько типов идентификаторов, которые могут быть использованы в REST-api:
Числовые идентификаторы: это наиболее простой тип идентификатора, который представляет собой уникальное число. Пример: `http://example.com/products/123`.
Строковые идентификаторы: это тип идентификатора, который представляет собой уникальную строку. Пример: `http://example.com/products/abc123`.
UUID-идентификаторы: это тип идентификатора, который представляет собой уникальный универсальный идентификатор (UUID). Пример: `http://example.com/products/4f4f4f4f-4f4f-4f4f-4f4f-4f4f4f4f4f4f`.