Какие функции можно реализовать через DELETE?

Функции, реализуемые через DELETE

DELETE — это HTTP-метод, используемый для удаления ресурсов на сервере. Однако на практике DELETE используется не только для физического удаления данных, но и для реализации различных функций и операций.

1. Прямое удаление ресурсов

Полное удаление данных

• DELETE /api/v1/users/123 — удалить пользователя с ID 123
• DELETE /api/v1/posts/456 — удалить пост
• Ресурс больше не доступен
• Обычно возвращает 204 No Content (успех без ответа) или 200 OK с подтверждением

Логическое удаление (Soft Delete)

• Ресурс не удаляется физически, но помечается как удалённый
• Пример: DELETE /api/v1/users/123 → в БД устанавливается флаг deleted=true и timestamp
• Используется для восстановления, аудита, хранения истории
• Очень важно в бизнес-приложениях (закон о хранении данных, возможность восстановления)

2. Отмена и откат операций

Отмена заказа

• DELETE /api/v1/orders/789 — отменить заказ
• Заказ остаётся в системе, но помечается как отменённый
• Status меняется с pending → cancelled
• Часто требует дополнительных действий (возврат денег, уведомление поставщика)

Отмена подписки

• DELETE /api/v1/subscriptions/123 — отменить подписку
• Клиент больше не будет получать услугу
• Может быть отложенная отмена (до конца текущего платёжного периода)

Откат транзакции

• DELETE /api/v1/transactions/456 — откатить платёж
• Возвращение денег клиенту
• Требует синхронизации с платёжной системой

3. Удаление связей и принадлежности

Удаление из списка/коллекции

• DELETE /api/v1/users/123/favorites/456 — удалить товар из избранного
• DELETE /api/v1/playlists/789/songs/1000 — удалить песню из плейлиста
• Сами ресурсы (товар, песня) остаются, но связь удаляется

Отписка от группы

• DELETE /api/v1/groups/123/members/456 — исключить пользователя из группы
• DELETE /api/v1/teams/789/users/123 — удалить из команды

Удаление прав доступа

• DELETE /api/v1/documents/123/shares/user-456 — отозвать доступ пользователя к документу
• DELETE /api/v1/resources/789/permissions/role-admin — отозвать права роли

4. Прекращение и отключение

Отключение уведомлений

• DELETE /api/v1/notifications/preferences/123 — отключить тип уведомления
• DELETE /api/v1/user/notifications/settings/email — отписаться от email-ов

Отключение интеграции

• DELETE /api/v1/integrations/slack/123 — отключить Slack интеграцию
• DELETE /api/v1/oauth/tokens/456 — отозвать токен доступа
• Приложение теряет доступ к API

Удаление сессии

• DELETE /api/v1/sessions/123 — выйти из профиля (logout)
• DELETE /api/v1/auth/tokens/refresh-token — инвалидировать токен
• Пользователь больше не может использовать этот токен

5. Очистка и реинициализация

Удаление всех данных определённого типа

• DELETE /api/v1/cache — очистить кэш
• DELETE /api/v1/messages — удалить все сообщения (очистить чат)
• DELETE /api/v1/temp-files — удалить временные файлы

Сброс настроек

• DELETE /api/v1/user/preferences — сбросить предпочтения пользователя на значения по умолчанию
• DELETE /api/v1/settings/customization — вернуть стандартный вид

Очистка очереди

• DELETE /api/v1/queues/background-jobs — отменить все задачи в очереди
• DELETE /api/v1/notifications/queue — очистить очередь уведомлений

6. Деактивация и архивирование

Деактивация аккаунта

• DELETE /api/v1/accounts/123 — деактивировать аккаунт (но не удалять данные)
• Аккаунт неактивен, пользователь не может логиниться
• Данные сохраняются для аудита и возможности восстановления

Архивирование проекта

• DELETE /api/v1/projects/456/active — перевести проект в архив
• Проект не отображается в активных, но данные остаются
• Может быть восстановлен позже

7. Удаление черновиков и временных данных

Отмена черновика

• DELETE /api/v1/drafts/123 — удалить черновик сообщения
• Черновик удаляется, так как это не опубликованная версия

Удаление загружаемых файлов

• DELETE /api/v1/uploads/456 — удалить временно загруженный файл
• Если файл не был использован в течение времени

8. Отмена действий, требующих подтверждения

Отмена запроса на дружбу

• DELETE /api/v1/friend-requests/123 — отменить отправленный запрос
• DELETE /api/v1/invitations/456 — отменить приглашение

Отмена заявления

• DELETE /api/v1/applications/789 — отозвать отправленную заявку на работу

9. Очистка истории и логов

Удаление истории просмотров

• DELETE /api/v1/user/history — очистить историю просмотров
• DELETE /api/v1/user/search-history — удалить историю поиска

Удаление логов действий

• DELETE /api/v1/audit-logs/old — удалить логи старше N дней (требует авторизации админа)

10. Удаление комментариев и обратной связи

Удаление отзыва

• DELETE /api/v1/products/123/reviews/456 — удалить отзыв о товаре
• DELETE /api/v1/posts/789/comments/1000 — удалить комментарий

Удаление оценки

• DELETE /api/v1/products/123/ratings/456 — удалить оценку пользователя

Best Practices при использовании DELETE

Авторизация и аутентификация

• Проверь, что пользователь имеет право удалять этот ресурс
• DELETE более опасен, чем GET или POST, требует повышенной безопасности

Идемпотентность

• DELETE должен быть идемпотентным: повторный вызов не должен вызывать ошибку
• Второе удаление уже удалённого ресурса: возврат 404 или 204

Каскадное удаление

• Если удаляется ресурс, что делать с зависимыми данными?
• Пример: удаление пользователя — удалить его комментарии? его заказы?
• Должно быть явно документировано

Возможность отката

• Используй soft delete, если нужна возможность восстановления
• Сохраняй deleted_at timestamp и who_deleted информацию

Уведомление других сервисов

• Если есть микросервисы, они должны быть уведомлены об удалении
• Пример: удаление заказа — надо обновить статистику, отправить уведомление поставщику

Логирование

• Логируй все DELETE операции для аудита
• Кто удалил, что удалил, когда, с какой причиной

Коды ответов при DELETE

• 200 OK — успешно удалено, в ответе информация о удалённом ресурсе
• 204 No Content — успешно удалено, нет содержимого в ответе (стандартно)
• 404 Not Found — ресурс не найден
• 403 Forbidden — нет прав на удаление
• 409 Conflict — конфликт (например, нельзя удалить заказ в определённом статусе)

Заключение

DELETE — это не просто операция удаления. Это инструмент для реализации отмены, деактивации, очистки, отписки и многих других функций. Правильное использование DELETE требует понимания бизнес-логики и тщательного проектирования.