Seleccione la pestaña
ESET PROTECT On-Prem – Índice

Cómo funciona API

Tipos de llamada API

Los tipos de llamada API GET, POST y DELETE están disponibles en la API de ESET PROTECT On-Prem.

Las llamadas GET contienen cualquier tipo de parámetro de entrada (no tienen cuerpo) y envían datos directamente en la URL. La llamada de solicitud no puede modificarse: solo puede ejecutarse.

Las llamadas POST necesitan un cuerpo de solicitud: los parámetros están documentados para cada llamada POST.

En solicitudes de API que incluyen la paginación (page_size), el tamaño de página predeterminado es 100 y el tamaño máximo es 10000.

Cada llamada consta de:

Tipo de llamada

URL de solicitud

Cabecera de solicitud (puede ser el token de autenticación)

Cuerpo de solicitud (contiene datos, especialmente en las llamadas POST)

Estructura de la respuesta del servidor

Cada llamada API recibe una respuesta del servidor de REST. La respuesta consiste en el código de respuesta del servidor y la respuesta con formato de datos JSON.

La respuesta consta de:

Código de servidor

Cuerpo de respuesta

Cabeceras de respuesta

Ejemplos de llamadas API

GET

Muestre una política (el Policy_UUID se toma de Web Console):

Método

GET

Función

Get Policy

URL

https://protect_server:9443/v2/policies/Policy_UUID

Cuerpo

 

Autorización

Bearer token

POST

Mueva el dispositivo a un grupo estático específico (el ID del ordenador está incluido en la URL):

Método

POST

Función

Move device

URL

https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move

Cuerpo

{

"newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1"

}

Autorización

Bearer token