• L’API REST è disponibile sotto l’URL di base:

/public/external/api

• Tutte le richieste devono essere inviate tramite POST.
• L’API REST supporta solo le richieste via HTTPS.
• Le richieste devono contenere le seguenti intestazioni:

• Il corpo della richiesta deve essere un oggetto codificato json che deve contenere i seguenti valori:

• In caso di successo, l’API restituisce i dati richiesti (vedi le Query di seguito) e un codice di stato HTTP 200.
• Se si verifica un errore, il codice di stato HTTP sarà compreso tra 4xx e 5xx a seconda dell’errore e l’oggetto risposta conterrà un array con la chiave “errors”, che contiene un elenco di messaggi di errore leggibili dall’uomo.
• Se non ci sono dati corrispondenti per un dispositivo, verrà restituito un array vuoto.
• Se l’Id di un dispositivo non esiste, i dati restituiti saranno nulli.