Kako API radi
Vrste API poziva
Vrste GET, POST i DELETE API poziva dostupne su u ESET PROTECT On-Prem API.
•GET pozivi sadrže sve ulazne parametre (nemaju glavni dio) i šalju podatke izravno u URL. Poziv zahtjeva ne može se mijenjati; samo pokrenuti.
•POST pozivi zahtijevaju glavni dio zahtjeva – parametri se dokumentiraju za svaki POST poziv.
•U API zahtjevima koji uključuju brojeve stranica (page_size), zadana veličina stranice je 100, a maksimalna veličina je 10000.
Svaki poziv sastoji se od:
•Vrsta poziva
•URL zahtjeva
•Zaglavlje zahtjeva (može se sastojati od autorizacijskog tokena)
•Glavni dio zahtjeva (sadrži podatke, posebno kod POST poziva)
Struktura odgovora servera
Svaki API poziv prima odgovor od REST servera. Odgovor se sastoji od koda odgovora servera i odgovora formatiranog kao podaci u JSON.
Odgovor se sastoji od:
•Kod servera
•Šifra odgovora
•Zaglavlja odgovora
Primjeri API poziva
GET
Prikaži pravilo (Policy_UUID preuzima se iz web konzole):
Metoda |
GET |
Funkcija |
|
URL |
https://protect_server:9443/v2/policies/Policy_UUID |
Tijelo |
|
Autorizacija |
Bearer token |
POST
Premjestite uređaj u određenu statičku grupu (ID računala je uključen u URL-u):
Metoda |
POST |
Funkcija |
|
URL |
https://protect_server:9443/v1/devices/a13f7d4c-e689-47cb-939d-91b9c9664a57:move |
Tijelo |
{ "newParentUuid": "be3d7451-e625-47fb-8f29-f98d61b40db1" } |
Autorizacija |
Bearer token |