Skip to main content

DELETE - Удаление серии задач

Описание​

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

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

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

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

Authorization: Bearer {your_access_token}

Параметры запроса​

  • Параметр в пути:
    • id (UUID): Уникальный идентификатор серии задач, которую необходимо удалить.

Пример URL:​

DELETE /task-executions/series/475c2d64-b564-4f17-9833-ac3793ee43b4

Ответ​

Успешный ответ​

  • Код состояния: 204 No Content
  • Описание: Серия задач была успешно удалена. Тело ответа не возвращается.

Ошибки​

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

  • Код: 400 Bad Request
  • Пример ответа: 
    {
      "message": "invalid input data",
      "code": "input.data.invalid",
      "timestamp": "2023-03-07T05:57:59.315Z",
      "details": [
        {
          "message": "invalid data type",
          "code": "data.type.invalid",
          "identifier": "id",
          "args": [
            "[UUID]"
          ]
        }
      ]
    }
  • Описание: Переданный id не соответствует ожидаемому формату UUID.

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

  • Код: 404 Not Found
  • Пример ответа: 
    {
      "message": "resource wasn't found",
      "code": "not.found",
      "timestamp": "2023-03-07T05:57:59.315Z"
    }
  • Описание: Указанный идентификатор серии задач id не существует в системе.

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

  • Код: 500 Internal Server Error
  • Пример ответа: 
    {
      "message": "internal server error",
      "code": "internal.server.error",
      "timestamp": "2023-03-07T05:57:59.315Z"
    }
  • Описание: Произошла неожиданная ошибка на сервере. Повторите запрос позже или обратитесь в техническую поддержку, если проблема не исчезнет.

Заключение​

Метод DELETE /task-executions/series/{id} предоставляет способ удалить серию задач по уникальному идентификатору. Успешное удаление возвращает статус 204 No Content, в то время как ошибки могут возникать из-за неверного формата id, отсутствующих ресурсов или проблем на сервере.