Cloud API
Last updated
Was this helpful?
Last updated
Was this helpful?
Le API Cloud di Trackle sono di tipo . REST significa che usiamo l'URL nel modo per cui è stato creato ovvero come "Uniform Resource Locator".
La risorsa in questione è il Dispositivo. Ogni dispositivo diventa un endpoint, che può essere usato per fare una richiesta GET
e ottenere un valore, o una POST
per chiamare una funzione remota o una PUT
per aggiornare il firmware.
Tutte le richieste ai dispositivi passano attraverso il nostro API Gateway con sicurezza TLS.
Le API REST accettano richieste in (content type application/json
) e in (content type application/x-www-form-urlencoded
). Rispondono sempre con un JSON (content type application/json
).
In questa documentazione trovi esempi di chiamate alle API utilizzando un programma da terminale chiamato che dovrebbe essere già installato sul tuo PC.
Gli esempi usano form encoded data cosi da essere più semplici da leggere e da capire ma tutti gli endpoint accettano anche oggetti JSON come parametri.
Le API Cloud di Trackle usano i codici di risposta HTTP convenzionali per indicare il successo o il fallimento di una richiesta alle API. In generale: i codici 2xx
indicano successo. I codici 4xx
indicano un errore che riguarda le informazioni fornite (es., un parametro richiesto è stato omesso, etc.).