L'API per pubblicare i valori di un segnale è
POST https://api.databoom.com/v1/signals/push/
Per effettuare la chiamata è sufficiente un OAuth token con permessi di Pubblicazione.
Il formato dei dati da inoltrare è disponibile nell'articolo Formato dei dati da inoltare
Nel body della richiesta è possibile specificare ance dei meta dati per aggiornare le proprietà dei segnali. Nello screenshot d'esempio vengono aggiornati
- type, il campo description del tipo di segnale (lista disponibile con API);
- tags, valori arbitrari da utilizzare successivamente come filtri nella lista segnali;
- unit, unità di misura del segnale.
La stessa chiamata in cURL si presenta come
curl --location --request POST 'http://127.0.0.1:3001/v1/signals/push/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <OAuth Token>' \
--data-raw '{
"device":"0hki456nf3",
"signals": [{
"name":"postman_signal",
"value":15,
"meta":{
"type":"temperatura",
"tags":["test","meta","push"],
"unit":"m"
}
}]
}'
L'API risponde con un messaggio di conferma
{
"message": "ALL_INFO_PROCESSED"
}
0 Commenti