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 |
|
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 |
|
URL |
https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move |
Cuerpo |
{ "newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1" } |
Autorización |
Bearer token |