Skip to main content

DELETE - Массовое удаление местоположений

Эндпоинт DELETE /locations/batch позволяет удалить несколько местоположений одновременно, указав их уникальные значения id в теле запроса.

Формат запроса​

HTTP метод: DELETE
Эндпоинт: /locations/batch

Пример тела запроса:​

[
  "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "54ccef81-dc56-4a6f-bfdc-7d47182ee1bb"
]
  • id: Массив уникальных идентификаторов (в формате UUID), представляющих местоположения, которые необходимо удалить.

Ошибки​

400 Bad Request - Неверные данные запроса​

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

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

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

Решение:

  • Убедитесь, что тело запроса представляет собой корректный JSON-массив строк id.
  • Проверьте, что каждый id имеет правильный формат UUID.

404 Not Found - Ресурс не найден​

Происходит, когда один или несколько указанных id не соответствуют существующим местоположениям.

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

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

Решение:

  • Проверьте, что все id в запросе соответствуют существующим местоположениям.
  • Тщательно проверьте правильность значений id.

406 Not Acceptable - Несоответствие типа контента​

Происходит, когда формат данных запроса или заголовок Content-Type не поддерживаются сервером.

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

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

Решение:

  • Убедитесь, что заголовок Content-Type установлен в application/json.
  • Проверьте, что формат тела запроса соответствует стандартам JSON.

500 Internal Server Error - Ошибка на сервере​

Происходит, когда возникает непредвиденная ошибка на стороне сервера.

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

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

Решение:

  • Повторите запрос позже.
  • Свяжитесь с технической поддержкой, если ошибка сохраняется.

Резюме​

Эндпоинт DELETE /locations/batch упрощает процесс удаления нескольких местоположений в одной операции. Чтобы успешно выполнить запрос:

  1. Укажите корректный JSON-массив UUID в теле запроса.
  2. Убедитесь, что каждый UUID соответствует существующему местоположению.
  3. Используйте правильный заголовок Content-Type.

Подробные сообщения об ошибках помогут эффективно выявить и устранить проблемы.