Cómo funciona API

Tipos de llamada de API

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

•Las llamadas GET contienen cualquier parámetro de entrada (no tienen cuerpo) y envían datos directamente en la URL. La llamada de solicitud no se puede modificar; solo se puede ejecutar.

•Las llamadas POST requieren un cuerpo de solicitud: los parámetros se documentan en cada llamada POST.

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

Cada llamada consta de lo siguiente:

•Tipo de llamada

•URL de solicitud

•Encabezado de la solicitud (puede constar del token de autenticación)

•Cuerpo de la solicitud (contiene datos, en especial con las llamadas POST)

Estructura de respuesta del servidor

Cada llamada de API recibe una respuesta del servidor de REST. La respuesta consta del código de respuesta del servidor y de la respuesta formateada como datos en formato JSON.

La respuesta consta de lo siguiente:

•Código del servidor

•Cuerpo de la respuesta

•Encabezados de la respuesta

Ejemplos de llamadas de API

GET

Mostrar una política (la Policy_UUID se toma de la consola web):

POST

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