Перейти к содержанию

Удаление инцидента

Запрос

Тип Метод
DELETE /service_asset_findings/{id}

Описание: при выполнении запроса будет удалён инцидент с указанным идентификатором.

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

DELETE

http://127.0.0.1/cruddy/v2/service_asset_findings/{id}

Path-параметры запроса:

Параметр Тип данных Обязательность Описание
id string Required Идентификатор удаляемого инцидента

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

Статус код: 200 – запрос успешно обработан.

Формат: JSON.

Параметры ответа:

Параметр Тип данных Описание
error string Текст ошибки
error_code integer Код результата удаления. Допустимые значения:
- 11002 — общая ошибка удаления;
- 11003 — запрос не затронул ни одной сущности;
- 11004 — удаляемый объект не найден;
- 11011 — удаление невозможно из-за наличия блокирующих связей
relations object RelationErrors Информация о связанных моделях, блокирующих удаление
Пример ответа 

{
  "error": "string",
  "error_code": 11002,
  "relations": {}
}

Другие возможные ответы

Код Ответ Описание
400 Bad Request Неверный тип параметра запроса, отсутствует обязательный параметр, отсутствует Pgr-User-ID или указан некорректный формат Pgr-User-ID
401 Unauthorized Невозможно аутентифицировать пользователя
404 not found Удаляемый объект не существует
500 Internal Server Error Другие ошибки при удалении объекта

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

  • 400 — "missing uid header" — отсутствует заголовок Pgr-User-ID;
  • 400 — "Pgr-User-Id should be uuid format" — неверный формат Pgr-User-ID;
  • 400 — "Bad Request" — неверный тип параметра запроса либо отсутствует обязательный параметр;
  • 400 — "id is empty" — не передан параметр id;
  • 401 — "can't get user info:" — невозможно аутентифицировать пользователя;
  • 404 — "not found" — удаляемый объект не существует;
  • 500 — "Internal Server Error" — другие ошибки при удалении объекта.

Примечание: Текст ошибки не фиксированный и может изменяться в зависимости от фактического ответа на запрос.

Пример ответа с кодом 400 

{
  "error": "Bad Request",
  "error_code": 400
}
Пример ответа с кодом 401 

{
  "error": "can't get user info:",
  "error_code": 401
}
Пример ответа с кодом 404 

{
  "error": "not found",
  "error_code": 404
}
Пример ответа с кодом 500 

{
  "error": "Internal Server Error",
  "error_code": 500
}