Funzionamento di API

Tipi di chiamate API

I tipi di chiamate GET, POST e DELETE API sono disponibili in ESET PROTECT On-Prem API.

•Le chiamate GET contengono parametri di input (che non includono un corpo) e inviano i dati direttamente nell’URL. La chiamata di richiesta non può essere modificata, ma solo eseguita.

•Le chiamate POST richiedono un corpo della richiesta: i parametri sono documentati per ogni chiamata POST.

•Nelle richieste API che includono la paginazione (page_size), la dimensione della pagina predefinita è 100 e la dimensione massima è 10000.

Ogni chiamata è composta da:

•Tipo di chiamata

•URL della richiesta

•Intestazione della richiesta (può corrispondere al token di autenticazione)

•Corpo della richiesta (contiene dati, specialmente con le chiamate POST)

Struttura della risposta del server

Ogni chiamata API riceve una risposta da REST Server. La risposta consiste nel codice di risposta del server e nella risposta formattata come dati in JSON.

La risposta è composta da:

•Codice del server

•Corpo della risposta

•Intestazioni della risposta

Esempi di chiamate API

GET

Visualizza un criterio (il criterio Policy_UUID è preso da Web Console):

POST

Sposta il dispositivo in un gruppo statico specifico (l’ID del computer è incluso nell’URL):