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

Обновлено: 21.06.2026

НазначениеНазначение

Удаление записи позволяет удалить существующую сущность из системы.

Для этого используется HTTP-метод DELETE с указанием идентификатора записи в URL.

После успешного удаления запись становится недоступной для дальнейшего чтения и изменения.

Базовый запросБазовый запрос

Например, удаление проекта:

DELETE https://api.timetta.com/odata/Projects('45eb27e2-161e-4eeb-9b56-72eaea30511d')

Если запрос выполнен успешно, API возвращает:

• 204 No Content

Это означает, что запись успешно удалена.

Удаление по идентификаторуУдаление по идентификатору

Удаление всегда выполняется по уникальному идентификатору сущности.

Например:

DELETE https://api.timetta.com/odata/Projects('45eb27e2-161e-4eeb-9b56-72eaea30511d')

Удаление агрегатовУдаление агрегатов

Если удаляется агрегатная сущность, связанные дочерние коллекции удаляются автоматически вместе с корневой записью.

Например:

• удаление ExpenseRequest приведёт к удалению связанных Lines;
• удаление ProjectVersion приведёт к удалению вложенных данных версии.

Это относится только к дочерним коллекциям, входящим в состав агрегата.

Ограничения удаленияОграничения удаления

Если сущность связана с независимыми объектами, удаление невозможно.

Например:

• проект используется в финансовых операциях;
• сотрудник участвует в утверждённых документах;
• задача участвует в связанных бизнес-процессах.

В таком случае API вернёт ошибку удаления.

Пример ответа:

{
  "error": {
    "code": "TmtDeleteException",
    "message": "Ошибка удаления сущности, возможно она уже используется."
  }
}

Такое поведение означает, что запись защищена от удаления из-за существующих зависимостей.

Обработка ошибокОбработка ошибок

Если запись успешно удалена:

• 204 No Content

Если запись не найдена:

• 404 Not Found

Если отсутствует или истёк токен доступа:

• 401 Unauthorized

Если недостаточно прав:

• 403 Forbidden

Если удаление невозможно из-за существующих зависимостей:

• 500 Internal Server Error

РекомендацииРекомендации

При удалении сущностей рекомендуется:

• учитывать, что дочерние коллекции агрегатов удаляются автоматически;
• учитывать, что связанные независимые сущности блокируют удаление;
• проверять наличие зависимых данных перед удалением;
• использовать удаление только для окончательного удаления записи;
• при необходимости использовать изменение состояния вместо удаления (например, архивирование).