Selecione a guia
ESET PROTECT On-Prem – Índice

Como o API funciona

Tipos de chamadas API

Os tipos de chamada GET, POST e DELETE API estão disponíveis no ESET PROTECT On-Prem API.

As chamadas GET contêm quaisquer parâmetros de entrada (não possuem corpo) e enviam dados diretamente na URL. A chamada de solicitação não pode ser modificada, apenas executada.

As chamadas POST exigem um corpo de solicitação – os parâmetros são documentados para cada chamada POST.

Nas solicitações API que incluem paginação (page_size), o tamanho de página padrão é 100 e o tamanho máximo é 10000.

Cada chamada consiste em:

Tipo de chamada

URL de solicitação

Cabeçalho da solicitação (pode consistir no token de autenticação)

Corpo da solicitação (contém dados, especialmente com chamadas POST)

Estrutura de resposta do servidor

Cada chamada API recebe uma resposta do servidor REST. A resposta consiste no código de resposta do servidor e na resposta formatada como dados no JSON.

A resposta consiste em:

Código do servidor

Corpo da resposta

Cabeçalhos de resposta

Exemplos de chamadas API

GET

Exibe uma política (a Policy_UUID é retirada do Web Console.):

Método

GET

Função:

Get Policy

URL

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

Corpo

 

Autorização

Bearer token

POST

Mova o dispositivo para um grupo estático específico (o ID do computador está incluído no URL):

Método

POST

Função:

Move device

URL

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

Corpo

{

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

}

Autorização

Bearer token