Это архитектурный стиль для создания веб-сервисов, который был предложен Роем Филдингом в его докторской диссертации в 2000 году. В его основе лежит принцип использования стандартных HTTP методов (GET, POST, PUT, DELETE и др.) для взаимодействия с ресурсами, представленными в виде URL.
🚩Основные принципы
🟠Адресуемость (Addressability)
Каждому ресурсу (например, пользователю, товару) соответствует уникальный URL.
🟠Использование стандартных методов HTTP
Использует методы HTTP для выполнения операций с ресурсами.
GET: Получение данных.POST: Создание нового ресурса.PUT: Обновление существующего ресурса.DELETE: Удаление ресурса.🟠Статусность (Statelessness)
Каждый запрос к серверу должен содержать всю необходимую информацию для его обработки. Сервер не хранит информацию о состоянии клиента между запросами.
🟠Кэширование (Caching)
Ответы от сервера могут кэшироваться, чтобы улучшить производительность и снизить нагрузку на сервер.
🟠Единообразие интерфейса (Uniform Interface)
Все взаимодействия между клиентом и сервером стандартизированы, что упрощает интеграцию и взаимодействие между системами.
🚩Примеры
🟠Получение списка пользователей (GET)
Запрос
GET /users
Ответ
[
{"id": 1, "name": "Alice"},
{"id": 2, "name": "Bob"}
]
🟠Получение информации о конкретном пользователе (GET)
Запрос
GET /users/1
Ответ
{
"id": 1,
"name": "Alice"
}🟠Создание нового пользователя (POST)
Запрос
POST /users
Content-Type: application/json
{
"name": "Charlie"
}
Ответ (Успешное создание)
{
"id": 3,
"name": "Charlie"
}🟠Обновление информации о пользователе (PUT)
Запрос
PUT /users/1
Content-Type: application/json
{
"name": "Alice Updated"
}
Ответ
{
"id": 1,
"name": "Alice Updated"
}🟠Удаление пользователя (DELETE)
Запрос
DELETE /users/1
Ответ (Успешное удаление)
{
"message": "User deleted"
}Ставь 👍 и забирай 📚 Базу знаний