Обнаружение сервисов
Запрос
Тип | Метод |
---|---|
POST |
/sonar/services/scan |
Описание: При выполнении запроса будет возвращен массив сервисов с информацией о хосте.
Пример запроса
POST
http://127.0.0.1/cruddy/v2/sonar/services/scan
Тело запроса:
Параметр | Тип данных | Обязательность | Описание |
---|---|---|---|
ips | Array<string> |
Required | Массив IP-адресов для сканирования |
Пример тела запроса
{
"ips": [
"192.168.0.1"
]
}
Успешный ответ
Статус код: 200
– запрос успешно обработан.
Формат: JSON
.
Параметры ответа:
Параметр | Тип данных | Описание |
---|---|---|
_ | Array <ServicesScanResult> |
Массив сервисов с информацией о хосте |
Пример ответа
{
"_": [
{
"ipv4": "192.168.0.1",
"ipv6": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"mac": "string",
"os": "string",
"services": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"created_at": "2023-12-20T00:00:01.652259Z",
"updated_at": "2023-12-20T00:00:01.652259Z",
"network_interface_id": "bec51eeb-07af-41bd-b9be-258f3c6716f0",
"port": 0,
"status": "string",
"type": "string",
"name": "string",
"version": "string",
"cpe": "cpe:/o:linux:kernel"
}
],
"error_code": 0,
"error": "string"
}
]
}
Другие возможные ответы
Код | Ответ | Описание |
---|---|---|
400 |
Bad Request empty ips empty IP address |
Неверный тип параметра запроса, либо отсутствует обязательный параметр Массив ip не задан Передан пустой IP-адрес |
500 |
Internal Server Error |
Другие ошибки при удалении объектов |
Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.
Пример ответа
Код 400
{ "error": "Bad Request", "error_code": 400 }
Код 500
{ "error": "Internal Server Error", "error_code": 500 }