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