GET suppliers
11 апреля 2024
ID 198637
Получение списка источников данных об угрозах и их статусов.
Возвращаются только источники данных об угрозах, созданные с помощью REST API, а также источники данных об угрозах FalsePositive и InternalTI.
Путь
/api/%API_VERSION%/suppliers
Метод
GET
Заголовки запроса
Этот запрос имеет следующие заголовки.
Заголовки запроса
Имя | Значение | Описание |
|---|---|---|
|
| |
|
| Тип содержимого ответа. |
Тело запроса
Тело этого запроса пустое.
Пример запроса
Ниже приведен пример запроса GET suppliers.
GET https://192.0.2.57/api/1.1/
Accept: application/json Authorization: Basic |
Заголовки ответа
Ответ имеет следующие заголовки.
Заголовки ответа
Имя | Значение | Описание |
|---|---|---|
Content-Type |
| Тип содержимого ответа. |
Content-Length |
| Размер тела ответа в байтах. |
Тело ответа
Тело ответа содержит массив объектов статуса источников данных об угрозах в формате JSON.
[
{
"name":"%SUPPLIER_NAME_1%",
"status": "%SUPPLIER_STATUS%"
},
...
{
"name":"%SUPPLIER_NAME_N%",
"status": "%SUPPLIER_STATUS%"
}
]
Описание свойств объекта статуса источника данных об угрозах приведено в следующей таблице.
Свойства объекта статуса источника данных об угрозах
Свойство | Значение | Описание |
|---|---|---|
|
| Имя источника данных об угрозах. |
|
| Статус источника данных об угрозах. Значение Значение |
Пример ответа
Ниже приведен пример ответа на запрос GET suppliers.
НТТР/1.1 200 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 99
[ {"name":"ExampleSupplier", "status":"enabled"}, {"name":"AnotherExampleSupplier", "status":"disabled"} ] |
Ответы с ошибкой
Ответы с ошибкой содержат информацию о статусе ответа.
Ответ с ошибкой содержит объект JSON с описанием ошибки.
[
{
"status": "An error occurred while getting a list of suppliers",
}
]
Описание свойств объекта ошибки приведено в следующей таблице.
Свойства объекта ошибки
Свойство | Значение | Описание |
|---|---|---|
|
| Описание ошибки. |
Пример ошибочного ответа
Ниже приведен пример ответа с ошибкой на запрос GET suppliers.
НТТР/1.1 500 Internal Server Error Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 63
[{"status": "An error occurred while getting a list of suppliers"}] |
