POST lookup
11 апреля 2024
ID 198540
Выполнение поиска индикатора.
Путь
/api/%API_VERSION%/lookup
Метод
POST
Заголовки запроса
Этот запрос имеет следующие заголовки.
Заголовки запроса
Имя | Значение | Описание |
|---|---|---|
|
| |
|
| Тип содержимого ответа. |
|
| Тип содержимого запроса. Также можно указать кодировку |
|
| Размер тела запроса в байтах. Максимальный размер тела этого запроса составляет 64 МБ ( |
Тело запроса
Тело этого запроса содержит массив объектов для поиска в формате JSON. Должен быть указан хотя бы один объект.
[{"object":"%OBJECT_VALUE%"},...{"object":"%OBJECT_VALUE%"}]
Описание свойств объекта приведено в следующей таблице.
Свойства объекта
Свойство | Значение | Обязательный | Описание |
|---|---|---|---|
|
| Да | Объект для поиска. |
Пример запроса
Ниже приведен пример запроса POST lookup.
POST https://192.0.2.57/api/1.1/lookup
Accept: application/json Content-Type: application/json Authorization: Basic Content-Length: 81
[{"object":"http:\/\/example.com"},{"object":"C1153422C5F68E731347F6A33F791598"}] |
Заголовки ответа
Ответ имеет следующие заголовки.
Заголовки ответа
Имя | Значение | Описание |
|---|---|---|
Content-Type |
| Тип содержимого ответа. |
Content-Length |
| Размер тела ответа в байтах. |
Тело ответа
Тело ответа содержит массив объектов результатов поиска в формате JSON.
[
{
"object": "%OBJECT_VALUE%",
"result": "%LOOKUP_RESULT%",
"categories":
[
{
"category": "%CATEGORY_1%",
"detected_indicator": "%DETECTED_INDICATOR%",
"context":
{
"%supplier_field_1%": "%supplier_field_1_value%",
...
"%supplier_field_N%": "%supplier_field_N_value%"
}
},
...
{
"category": "%CATEGORY_N%",
"detected_indicator": "%DETECTED_INDICATOR%",
"context":
{
"%supplier_field_1%": "%supplier_field_1_value%",
...
"%supplier_field_N%": "%supplier_field_N_value%"
}
}
]
},
...
{
"object": "%OBJECT_VALUE%",
"result": "%LOOKUP_RESULT%",
"categories":
[
{
"category": "%CATEGORY_1%",
"detected_indicator": "%DETECTED_INDICATOR%",
"context":
{
"%supplier_field_1%": "%supplier_field_1_value%",
...
}
},
...
]
}
]
Свойства объекта результатов поиска описаны в следующей таблице.
Свойства объекта результатов поиска
Свойство | Значение | Описание |
|---|---|---|
|
| Объект, поиск которого выполнялся. |
|
| Результат поиска. Возможны следующие значения:
|
|
| Массив объектов категорий, см. описание ниже. Это свойство включается, если result имеет значение |
|
| Причина ошибки. |
Свойства объектов категории описаны в следующей таблице.
Свойства объекта категории
Свойство | Значение | Описание |
|---|---|---|
|
| Категория обнаружения киберугрозы. |
|
| Сопоставленный индикатор. |
|
| Массив объектов контекста. |
Свойства объектов контекста описаны в следующей таблице.
Свойства объекта контекста
Свойство | Значение | Описание |
|---|---|---|
|
| Имя свойства соответствует имени одного из полей сопоставленного индикатора. Значение свойства содержит значение поля. |
Пример ответа
Ниже приведен пример ответа на запрос POST lookup.
НТТР/1.1 200 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 372
[{"object":"http:\/\/example.com","result":"not detected"}, {"object":"C1153422C5F68E731347F6A33F791598","result":"detected", "detects": [{"category":"KL_Malicious_Hash","detected_indicator":"C1153422C5F68E731347F6A33F791598","context":{"first_seen":"10.07.2015 23:53","threat":"Trojan.Win32.Generic"}}]} ] |
Ответы с ошибкой
Ответы с ошибкой содержат информацию о статусе ответа.
Ответ с ошибкой содержит объект JSON с описанием ошибки.
[
{
"status": "%ERROR%"
}
]
Описание свойств объекта ошибки приведено в следующей таблице.
Свойства объекта ошибки
Свойство | Значение | Описание |
|---|---|---|
|
| Описание ошибки. |
|
| Причина ошибки. |
Пример ошибочного ответа
Ниже приведен пример ответа с ошибкой на запрос POST lookup.
НТТР/1.1 500 Internal Server Error Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 75
[{"status": "An error occurred while creating supplier", "reason": "Supplier already exists"}] |
