HTTP: методы и статусы

GET, POST, PUT, DELETE — что они означают и когда использовать.

GET

Получить данные. Тела нет. Параметры в URL.

Используется: Получить список, один объект, результат поиска

✓ Безопасный✓ Идемпотентный

Запрос

GET /api/users/42 HTTP/1.1
Host: api.example.com
Authorization: Bearer token123

Ответ

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": 42,
  "name": "Иван",
  "email": "ivan@example.com"
}

Шаг 1 из 4

HTTP-методы (глаголы)

Зачем нужны методы?

HTTP-методы — это глаголы, которые говорят серверу что делать с ресурсом.

Основные методы

Метод	Действие	Аналогия
GET	Получить данные	Прочитать статью
POST	Создать новое	Написать комментарий
PUT	Заменить целиком	Переписать статью
PATCH	Изменить частично	Исправить опечатку
DELETE	Удалить	Удалить комментарий

Примеры API пользователей

http

GET    /api/users        → список всех пользователей
GET    /api/users/42     → пользователь с id=42
POST   /api/users        → создать нового пользователя
PUT    /api/users/42     → заменить пользователя 42 целиком
PATCH  /api/users/42     → обновить отдельные поля пользователя 42
DELETE /api/users/42     → удалить пользователя 42

CRUD → HTTP

Любую работу с данными (Create, Read, Update, Delete) можно выразить через HTTP:

Create → POST
Read → GET
Update → PUT или PATCH
Delete → DELETE

Клиент и сервер Что такое API