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

Обнаружение сервисов

Запрос

Тип Метод
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
}