DELETE suppliers/{supplier}

11 апреля 2024

ID 198645

Удаление указанного поставщика.

С помощью этого запроса могут удаляться только источники данных об угрозах, созданные с помощью REST API.

Путь

/api/%API_VERSION%/suppliers/{supplier}

Метод

DELETE

Заголовки запроса

Этот запрос имеет следующие заголовки.

Заголовки запроса

Имя

Значение

Описание

Authorization

string (base 64)

Строка аутентификации.

Accept

application/json

Тип содержимого ответа.

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

Этот запрос имеет следующие параметры:

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

Имя

Тип параметра

Описание

источник данных об угрозах

Путь

Имя источника данных об угрозах.

Тело запроса

Тело этого запроса пустое.

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

Ниже приведен пример запроса DELETE suppliers/{supplier}.

DELETE https://192.0.2.57/api/1.1/suppliers/ExampleSupplier

Accept: application/json

Authorization: Basic dXNlcjpwYXNzd29yZA==

Заголовки ответа

Ответ имеет следующие заголовки.

Заголовки ответа

Имя

Значение

Описание

Content-Type

application/json

Тип содержимого ответа.

Content-Length

integer

Размер тела ответа в байтах.

Тело ответа

Тело ответа содержит объект JSON со статусом операции.

[

{

"status": "Supplier successfully removed"

}

]

Свойства объекта статуса описаны в следующей таблице.

Свойства объекта статуса

Свойство

Значение

Описание

status

string

Статус операции.

Пример ответа

Ниже приведен пример ответа на запрос DELETE suppliers/{supplier}.

НТТР/1.1 201 ОК

Date:Mon, 23 Dec 2019 09:56:10 UTC

Content-Type: application/json

Content-Length: 46

[{"status": "Supplier successfully removed"}]

Ответы с ошибкой

Ответы с ошибкой содержат информацию о статусе ответа.

Ответ с ошибкой содержит объект JSON с описанием ошибки.

[

{

"status": "An error occurred while removing the supplier",

"reason": "%REASON%"

}

]

Описание свойств объекта ошибки приведено в следующей таблице.

Свойства объекта ошибки

Свойство

Значение

Описание

status

string

Описание ошибки.

reason

string

Причина ошибки.

Это свойство может отсутствовать в ответе.

Пример ошибочного ответа

Ниже приведен пример ответа с ошибкой на запрос DELETE suppliers/{supplier}.

HTTP/1.1 404 Supplier doesn't exist

Date:Mon, 23 Dec 2019 09:56:10 UTC

Content-Type: application/json

Content-Length: 86

 

[{"status": "An error occurred while removing the supplier", "reason": "Supplier doesn't exist"}]

Вам помогла эта статья?
Что нам нужно улучшить?
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!
Спасибо за ваш отзыв, вы помогаете нам становиться лучше!