Методы HTTP

HTTP-методы — это как "команды действий" для ваших данных.

В RESTful API мы в основном используем четыре метода, соответствующих четырём базовым операциям над данными:

HTTP-метод Назначение Соответствующая операция Аналогия из жизни
GET Получение данных Read Просмотреть меню
POST Создать данные Создайте Заказать блюда
PUT Обновление данных Update Изменить заказ
DELETE Удаление данных Delete Отмена заказа

Метод GET

GET используется для получения данных, как будто вы спрашиваете официанта: «Какие блюда у вас есть сегодня?»

// 获取所有用户
GET /api/users

// 获取特定用户
GET /api/users/123

// 获取用户的订单
GET /api/users/123/orders

Особенности:

  • Безопасная операция, не изменяет данные
  • Можно кэшировать
  • Параметры передаются в URL

Метод POST

POST используется для создания новых данных, как будто вы говорите официанту: «Я хотел бы заказать курицу Кунг-Пао»

// 创建新用户
POST /api/users
{
  "name": "张三",
  "email": "zhangsan@example.com"
}

// 创建新订单
POST /api/orders
{
  "userId": 123,
  "items": ["商品A", "商品B"]
}

Особенности:

  • Изменяет состояние сервера
  • Не идемпотентен (несколько вызовов создадут несколько ресурсов)
  • Данные передаются в теле запроса

Метод PUT

PUT используется для обновления всего ресурса, как будто вы говорите: «Измените мой заказ на этот»

// 更新用户信息
PUT /api/users/123
{
  "name": "李四",
  "email": "lisi@example.com",
  "phone": "13800138000"
}

Особенности:

  • Идемпотентен (несколько вызовов дают одинаковый результат)
  • Обычно заменяет весь ресурс
  • Если ресурс не существует, он может создать новый ресурс

Метод DELETE

DELETE используется для удаления ресурса, как будто вы говорите: «Отмените мой заказ»

// 删除用户
DELETE /api/users/123

// 删除订单
DELETE /api/orders/456
  • Является идемпотентным
  • Удаляет указанный ресурс
  • После успешного выполнения ресурс больше не существует

Коды состояния HTTP

После обработки запроса сервер возвращает код состояния, сообщающий результат:

Код состояния Значение Описание
200 ОК Запрос выполнен успешно
201 Создано Ресурс успешно создан
400 Некорректный запрос Некорректный запрос
401 Не авторизован Не авторизован
404 Не найдено Ресурс не найден
500 Внутренняя ошибка сервера Внутренняя ошибка сервера
Другие расширения