Saltar al contenido principal
POST
/
scans
/
cve
/
scheduled
/
single-ip
Iniciar Escaneo Bajo Demanda para una Sola IP
curl --request POST \
  --url https://api.altostrat.io/scans/cve/scheduled/single-ip \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "schedule_id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "site_id": "9c3c1392-7f36-4240-85f2-273573c0384a",
  "ip_address": "192.168.1.55"
}'
{
  "scan_id": "9c46a6f1-a8d8-4f5a-9b2f-7d1b3e9c5a1d",
  "status": "pending",
  "ip_address": "192.168.1.55",
  "site_id": "9c3c1392-7f36-4240-85f2-273573c0384a",
  "created_at": "2025-10-29T14:00:00Z",
  "message": "Escaneo iniciado. Vuelva a consultar más tarde para ver los resultados."
}

Authorizations

​
Authorization
string
header
required

Ingrese su token de portador en el formato: Bearer {token}

Body

application/json

Detalles del escaneo a iniciar.

​
schedule_id
string<uuid>
required

El ID de la programación cuya configuración se utilizará para el escaneo.

Example:

"9c43cc95-f313-49a3-b632-524f7a24503b"

​
site_id
string<uuid>
required

El ID del sitio donde se encuentra la dirección IP de destino.

Example:

"9c3c1392-7f36-4240-85f2-273573c0384a"

​
ip_address
string<ipv4>
required

La dirección IPv4 específica a escanear.

Example:

"192.168.1.55"

Response

El escaneo de una sola IP ha sido aceptado y está pendiente de ejecución.

​
scan_id
string<uuid>

El identificador único para el objeto de escaneo padre recién creado.

Example:

"9c46a6f1-a8d8-4f5a-9b2f-7d1b3e9c5a1d"

​
status
string

El estado inicial de la solicitud de escaneo.

Example:

"pending"

​
ip_address
string<ipv4>

La dirección IP que fue el objetivo.

Example:

"192.168.1.55"

​
site_id
string<uuid>

El ID del sitio que fue el objetivo.

Example:

"9c3c1392-7f36-4240-85f2-273573c0384a"

​
created_at
string<date-time>

Marca de tiempo de cuándo se inició el escaneo.

Example:

"2025-10-29T14:00:00Z"

​
message
string

Un mensaje de confirmación.

Example:

"Escaneo iniciado. Vuelva a consultar más tarde para ver los resultados."