ESET PROTECT On-Prem

Offline | Prejsť do režimu online

ESET PROTECT On-Prem – Obsah

# Ako API funguje?

Skopírovať odkaz na aktuálny článok Odoslať e‑mailom

## Typy volaní API

Typy volaní GET, POST a DELETE rozhrania API sú dostupné v ESET PROTECT On-Prem API.

•Volania GET neobsahujú žiadne vstupné parametre (nemajú telo) a odosielajú údaje priamo v URL adrese. Volanie požiadavky nie je možné upraviť; dá sa iba vykonať.

•Volania POST vyžadujú telo požiadavky – parametre sú zdokumentované pre každé volanie POST.

•Pri požiadavkách API, ktoré obsahujú stránkovanie (page_size), je predvolená veľkosť stránky 100 a maximálna veľkosť je 10000.

Každé volanie pozostáva z:

•typu volania,

•URL požiadavky,

•hlavičky požiadavky (môže obsahovať autentifikačný token),

•tela požiadavky (obsahuje údaje, najmä pri volaniach POST).

## Štruktúra odpovede servera

Každé volanie API prijme odpoveď zo servera REST. Odpoveď pozostáva z kódu odpovede servera a odpovede vo formáte JSON.

Odpoveď obsahuje:

•kód servera,

•telo odpovede,

•hlavičky odpovede.

## Príklady volaní API

### GET

Zobrazenie politiky (Policy_UUID sa získa z Web Console):

Metóda | GET
Funkcia | Get Policy
URL | https://protect_server:9443/v2/policies/Policy_UUID
Telo |
Autorizácia | Bearer token

### POST

Presun zariadenia do konkrétnej statickej skupiny (ID počítača je súčasťou URL adresy):

Metóda | POST
Funkcia | Move device
URL | https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move
Telo | { "newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1" }
Autorizácia | Bearer token

˄˅