Dispositivi
I Dispositivi sono associati al tuo account e possono essere parte di un Prodotto. Un Prodotto identifica un gruppo di dispositivi con lo stesso hardware e le stesse funzionalità . Ogni Prodotto ha la sua flotta di dispositivi associati.
Gli endpoint per i dispositivi possono essere usati anche per i dispositivi che sono parte di un prodotto sostituendo /v1/devices
con /v1/products/:productIdOrSlug/devices
.
Lista dispositivi
GET
https://api.trackle.io/v1/devices
Ottieni la lista dei dispositivi a cui l'utente autenticato ha accesso. Di default, la lista è ordinata per last_heard
in ordine decrescente.
Lista dispositivi associati ad un prodotto
GET
https://api.trackle.io/v1/products/:productIdOrSlug/devices
Ottieni la lista dei dispositivi che sono parte di un Prodotto.
Path Parameters
Name | Type | Description |
---|---|---|
productIdOrSlug | string | ID prodotto o Slug |
Query Parameters
Name | Type | Description |
---|---|---|
groups | string | Lista di nomi di gruppo separati da virgola per filtrare i risultati mostrando solo i dispostivi appartenenti a quei gruppi |
Ottieni informazioni di un dispositivo
GET
https://api.trackle.io/v1/devices/:deviceID
Ottieni le informazioni di un singolo dispositivo, incluse le variabili e le funzioni esposte.
Path Parameters
Name | Type | Description |
---|---|---|
deviceID | string | ID Dispositivo |
productIdOrSlug | string | ID Prodotto o Slug. Solo per endpoint Prodotto |
Ottieni il valore di una variabile
GET
https://api.trackle.io/v1/devices/:deviceID/:variableName
Ottieni il valore corrente di una variabile esposta dal dispsitivo. Le variabili possono essere lette da un dispositivo di cui l'utente è proprietario oppure da uno che è parte di un Prodotto di cui l'utente è nel team.
Path Parameters
Name | Type | Description |
---|---|---|
deviceID | string | ID Dispositivo |
variableName | string | Nome variabile |
productIdOrSlug | string | ID Prodotto o Slug. Solo per endpoint Prodotto |
Chiama una funzione remota
POST
https://api.trackle.io/v1/devices/:deviceID/:functionName
Chiama una funzione remota esposta dal dispositivo passando un parametro di tipo stringa. Le funzioni possono essere chiamate da un dispositivo di cui l'utente è proprietario oppure da uno che è parte di un Prodotto di cui l'utente è nel team.
Path Parameters
Name | Type | Description |
---|---|---|
deviceID | string | ID Dispositivo |
functionName | string | Nome della funzione |
productIdOrSlug | string | ID Prodotto o Slug. Solo per endpoint Prodotto |
Request Body
Name | Type | Description |
---|---|---|
args | string | Parametri della funzione con lunghezza massima di 622 caratteri |
Pinga un dispositivo
PUT
https://api.trackle.io/v1/devices/:deviceID/ping
Path Parameters
Name | Type | Description |
---|---|---|
deviceID | string | ID Dispositivo |
productIdOrSlug | string | ID Prodotto or Slug. Solo per endpoint Prodotto |
Genera un codice di claim
POST
https://api.trackle.io/v1/device_claims
Genera un codice di claim che permette di ad un utente di Trackle di diventare proprietario di un dispositivo e quindi avere il permesso di monitorarlo e controllarlo. Usando l'endpoint di Prodotto è possibile generare un codice di claim per un dispositivo parte di un Prodotto. Il codice deve essere generato usando l'access token dell'utente che vuole diventare proprietario del dispositivo.
Path Parameters
Name | Type | Description |
---|---|---|
productIdOrSlug | string | ID Prodotto o Slug. Solo per endpoint Prodotto |
Last updated