E’ possibile pubblicare sulla piattaforma iXemWine i dati misurati da qualsiasi tipologia di sensore o aggregazione di sensore che rispetti l’elenco pubblicato nella pagina “Tecnologia”.
Per pubblicare i dati occorre seguire la seguente procedura.
- Registrare gratuitamente un account sulla piattaforma iXemWine a questo indirizzo
- Inviare la richiesta all’indirizzo email info@ixem.wine con oggetto “Richiesta integrazione sensore“, specificando nel corpo della mail le seguenti informazioni:
- Indirizzo usato per la registrazione dell’account iXemWine
- Per ogni sensore o aggregazione di sensori che si vogliono pubblicare, specificare il tipo di sensore o di aggregazione, le coordinate GPS (latitudine e longitudine) e il nome del vigneto
- Per ogni dispositivo dichiarare marca e modello con in allegato una fotografia dello stesso
- Solo nel caso di aggregazioni di sensori è necessario indicare un indice numerico progressivo a partire da 1 per ogni sensore, nella forma tipo-indice
Una volta validati i dati, verranno inviate all’utente le seguenti informazioni:
-
- Per ogni vigneto e per ogni aggregazione un ID univoco
- Una API Key con cui si potranno autenticare le richieste per l’invio dati
La trasmissione di ogni dato deve essere effettuata mediante una richiesta HTTP come segue.
- Il metodo HTTP da usare è il POST
- Il request URI da seguire deve essere
https://api.ixem.wine/v2/external/uplink - Impostare un header aggiuntivo per l’autenticazione come
Authentication: Bearer API_KEY
Il body della richiesta deve essere formattato in JSON.
{
"dev_id": "my-dev-id", // I'ID assegnato per la centralina
"port": 99, // Necessario per la compatibilità
"is_retry": false, // Necessario per la compatibilità
"payload_fields": {}, // Contiene i valori letti dalla centralina
"metadata": {
"time": "1970-01-01T00:00:00Z", // Data è ora di afferenza della misurazione
"gateways": [], // Lasciato vuoto per compatibilità
"latitude": 0,
"longitude": 0,
"altitude": 0
}
}
Il campo payload_field è un semplice oggetto contente come chiave il tipo di sensore; nel caso di una aggregazione è necessario aggiungere un indice progressivo che individua il sensore fisico secondo un ordine prestabilito come indicato nella mail. Ad esempio temperature_1 o humidity_2.
Adesivo personalizzato
Una volta che la procedura di pubblicazione sarà completata e operativa, riceverai gratuitamente un adesivo per ogni sensore; potrai decidere liberamente se applicarlo al tuo dispositivo oppure no.
Note sull’applicazione della procedura
- Ogni richiesta HTTP inviata al server deve fare riferimento solo ed esclusivamente ad una misurazione, molteplici misurazioni devono essere trasmesse con singole richieste HTTP
- Tra una richiesta e l’altra (relativa ad un singolo sensore o aggregazione di sensori) devono intercorrere almeno 10 minuti di tempo
- I dati trasmessi nonché la geo localizzazione dichiarata devono essere veritieri, in caso di variazioni deve essere data immediata comunicazione via mail