Skip to main content

DELETE - Массовое удаление чек-листов

Эндпоинт DELETE /check-lists/batch позволяет удалять несколько чек-листов за один запрос.

Детали запроса​

  • Метод: DELETE
  • Эндпоинт: /check-lists/batch
  • Заголовки:
    • Authorization: Требуется токен доступа.
    • Content-Type: application/json.
  • Тело запроса: Массив строк, где каждая строка — это уникальный идентификатор чек-листа (UUID).

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

URL:
https://api.targpatrol.com/v1/check-lists/batch

Тело запроса:

[
  "ec946270-545c-4e51-ac5d-a6980dbd1575",
  "261be68e-df86-4705-ac33-ba318996f155"
]

Ответы сервера​

Успешное удаление​

При успешном выполнении запроса сервер возвращает код состояния 204 No Content с пустым телом ответа.

Ответы об ошибках​

Неверные данные запроса​

Возникает, если данные запроса некорректно отформатированы или содержат недопустимые типы.

Ответ:

{
  "message": "invalid input data",
  "code": "input.data.invalid",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Решение: Убедитесь, что тело запроса содержит массив строк в формате валидных UUID.

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

Возникает, если один или несколько указанных чек-листов отсутствуют в системе.

Ответ:

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

Решение: Проверьте правильность указанных идентификаторов чек-листов и убедитесь, что они существуют в системе.

Несоответствие типа контента​

Возникает, если заголовок Content-Type отсутствует или данные запроса не являются корректным JSON.

Ответ:

{
  "message": "mismatch in the types of content",
  "code": "not.acceptable",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Решение: Убедитесь, что тело запроса корректно отформатировано в JSON, и указаны соответствующие заголовки.

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

Возникает из-за технической проблемы на стороне сервера.

Ответ:

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

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

Итог​

Эндпоинт DELETE /check-lists/batch предоставляет удобный способ массового удаления чек-листов. Убедитесь, что данные запроса правильно отформатированы, чтобы успешно выполнить операцию.