Skip to main content

DELETE - Удаление задачи по ID

Описание​

Метод DELETE /task-executions/{id} используется для удаления выполнения задачи из системы по его уникальному идентификатору. Эта операция безвозвратно удаляет запись о выполнении задачи.

Авторизация​

Для использования этого метода требуется токен доступа. Включите его в заголовок запроса.

Пример заголовка авторизации:​

Authorization: Bearer {your_access_token}

Пример запроса​

URL:​

DELETE https://api.example.com/v1/task-executions/42f17f21-3ca4-4026-b578-4db633486a75

Ожидаемый ответ​

Код ответа:​

  • 204 No Content: Выполнение задачи успешно удалено, тело ответа отсутствует.

Возможные ошибки​

400 Некорректные входные данные​

Код ответа:​

400 Bad Request

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

{
  "message": "invalid data type",
  "code": "data.type.invalid",
  "identifier": "id",
  "args": [
    "[UUID]"
  ]
}

Описание:​

Переданный идентификатор задачи недействителен или не соответствует формату UUID.

404 Ресурс не найден​

Код ответа:​

404 Not Found

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

{
  "message": "resource wasn't found",
  "code": "not.found",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание:​

Указанный идентификатор выполнения задачи не существует в системе или уже был удален.

500 Внутренняя ошибка сервера​

Код ответа:​

500 Internal Server Error

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

{
  "message": "internal server error",
  "code": "internal.server.error",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание:​

Произошла неожиданная ошибка на сервере. Повторите запрос позже или обратитесь в техническую поддержку.

Итог​

Метод DELETE /task-executions/{id} позволяет удалить выполнение задачи из системы по уникальному идентификатору. Убедитесь, что переданный id действителен и имеет правильный формат, чтобы избежать ошибок. Обрабатывайте возможные проблемы, такие как отсутствие ресурса или сбои сервера.