Skip to main content

DELETE - Удаление местоположения по ID

Эндпоинт DELETE /locations/{id} используется для постоянного удаления конкретного местоположения, идентифицируемого его уникальным ID. Это действие удаляет местоположение из базы данных.

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

HTTP метод: DELETE
Эндпоинт: /locations/{id}

Параметр пути:​

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

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

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

Происходит, когда предоставленный id имеет неправильный формат (например, не является допустимым UUID).

Код ответа:​

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 - Ресурс не найден​

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

Код ответа:​

404 Not Found

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

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

Решение:

  • Проверьте правильность id и убедитесь, что оно соответствует существующему местоположению.

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

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

Код ответа:​

500 Internal Server Error

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

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

Решение:

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

Резюме​

Эндпоинт DELETE /locations/{id} позволяет безопасно и эффективно удалять местоположения. В случае ошибок сервер предоставляет подробные сообщения, чтобы помочь в устранении проблем, таких как неверные ID или несуществующие местоположения. Это гарантирует, что пользователи смогут эффективно решать проблемы и продолжать выполнение запроса на удаление при необходимости.