Какие виды запросов отвечают за каждый параметр CRUD?

Соответствие HTTP-методов операциям CRUD

В веб-разработке, особенно во Frontend, взаимодействие с сервером через RESTful API или GraphQL чаще всего строится на соответствии HTTP-методов операциям CRUD (Create, Read, Update, Delete). Это стандартная конвенция, которую должен понимать каждый frontend-разработчик.

Основное соответствие

• Create (Создание) → HTTP POST

    *   Метод `POST` используется для создания новых ресурсов на сервере.
    *   Данные для создания (например, объект пользователя или статьи) передаются в **теле запроса (request body)**, обычно в формате JSON.
    *   Сервер, как правило, возвращает код состояния `201 Created` и созданный ресурс (часто с присвоенным `id`).

```javascript
// Пример на JavaScript (Fetch API)
const newUser = { name: 'Алексей', email: 'alex@example.com' };
const response = await fetch('https://api.example.com/users', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(newUser)
});
const createdUser = await response.json(); // { id: 123, name: 'Алексей', ... }
```

• Read (Чтение) → HTTP GET

    *   Метод `GET` предназначен для **получения** данных с сервера. Это идемпотентный и безопасный метод (не должен изменять состояние сервера).
    *   Используется для запроса одной сущности (`/users/123`) или коллекции (`/users`).
    *   Параметры запроса (фильтрация, пагинация) передаются в **URL (query string)**.
    *   Успешный ответ — код `200 OK` с данными в теле.

```javascript
// Получение списка с пагинацией
const response = await fetch('https://api.example.com/users?page=2&limit=20');
const userList = await response.json();

// Получение конкретного пользователя
const singleUserResponse = await fetch('https://api.example.com/users/123');
```

• Update (Обновление) → HTTP PUT или PATCH

    *   **`PUT`** — используется для **полного обновления** ресурса. Клиент отправляет полное представление объекта, заменяя им существующий. Если ресурса нет, он может быть создан (зависит от API).
    *   **`PATCH`** — используется для **частичного обновления**. Отправляются только изменяемые поля, что удобно и экономично для больших объектов.

```javascript
// PUT — полное обновление
const updatedUser = { id: 123, name: 'Алексей', email: 'new_email@example.com' }; // Все поля
await fetch('https://api.example.com/users/123', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(updatedUser)
});

// PATCH — частичное обновление
const patchData = { email: 'new_email@example.com' }; // Только email
await fetch('https://api.example.com/users/123', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(patchData)
});
```

• Delete (Удаление) → HTTP DELETE

    *   Метод `DELETE` используется для удаления указанного ресурса.
    *   Запрос может не иметь тела. Успешный ответ — часто `200 OK` (с телом), `202 Accepted` (принято в обработку) или `204 No Content` (успешно, контент не возвращается).

```javascript
// Удаление пользователя
await fetch('https://api.example.com/users/123', {
  method: 'DELETE'
});
```

Важные нюансы для Frontend-разработчика

1. Идемпотентность и безопасность: GET, PUT, DELETE являются идемпотентными (многократное выполнение одного запроса дает тот же результат, что и однократное). GET также безопасен. Это важно для логики повтора запросов при ошибках сети.

2. Статус-коды ответов: Умение обрабатывать их — ключевой навык.

    *   `200 OK` / `201 Created` — успех.
    *   `400 Bad Request` — ошибка в запросе (валидация).
    *   `401 Unauthorized` / `403 Forbidden` — проблемы авторизации.
    *   `404 Not Found` — ресурс не существует.
    *   `500 Internal Server Error` — ошибка сервера.

1. Content-Type и CORS: Для POST, PUT, PATCH важно явно указывать заголовок Content-Type: application/json. Все нетривиальные запросы (не GET, HEAD, POST с простыми формами) проходят проверку CORS, которую нужно корректно настраивать на бэкенде.

2. Альтернативы: GraphQL: В GraphQL модель CRUD мапится иначе. Обычно используется единственная POST-точка входа, а тип операции определяется типом запроса (Query, Mutation) в теле.

    *   **Read (R)** → Запрос типа `query`.
    *   **Create, Update, Delete (CUD)** → Запрос типа `mutation`.

```graphql
# Query (Read) — получение данных
query GetUser($id: ID!) {
  user(id: $id) {
    name
    email
  }
}

# Mutation (Create/Update/Delete) — изменение данных
mutation CreateUser($input: UserInput!) {
  createUser(input: $input) {
    id
    name
  }
}
```

Понимание этой связи между бизнес-операциями (CRUD) и сетевыми протоколами (HTTP/GraphQL) — фундамент для грамотного проектирования клиентской логики работы с данными, организации сервис-слоя приложения и эффективной отладки взаимодействия с бэкендом.