Методы 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 | Внутренняя ошибка сервера | Внутренняя ошибка сервера |