Link Search Menu Expand Document (external link)

API - Persistence Service

Temperature

POST /temperature/register

Header richiesti:

  • token
    Agent token ottenuto autenticandosi ad un Environment presso l’auth-service.

Parametri body:

  • timestamp
    Tipo: Data
    Formato: “1997-12-31T00:00:00.000+00:00”
    Obbligatorio: sì
    Data e orario del campionamento; la data e l’orario fanno riferimento all’UTC (Universal Time Coordinated).
  • value
    Tipo: Numerico
    Obbligatorio: si
    Valore campionato.

Risultato atteso: 201

  • id
    Identificativo del campionamento effettuato.

GET /temperature/latest

Header richiesti:

  • token
    Farmer token ottenuto autenticandosi con un account Farmer presso l’auth-service.

Risultato atteso: 200

  • timestamp
    Data e orario del campionamento; la data e l’orario fanno riferimento all’UTC (Universal Time Coordinated).
    Formato: “1997-12-31T00:00:00.000+00:00”

  • value
    Valore campionato.

GET /temperature/list

Header richiesti:

  • token
    Farmer token ottenuto autenticandosi con un account Farmer presso l’auth-service.

Parametri query:

  • id
    Tipo: Stringa
    Obbligatorio: sì
    Id dell’Environment (ottenuto dall’auth-service) della quale si vuole ottenere la lista di campionamenti.

Risultato atteso: 200

  • list
    Lista ordinata (dal più vecchio al più recente) di campionamenti della temperatura effettuati per il Setting specificato.

Air Humidity

POST /airHumidity/register

Header richiesti:

  • token
    Agent token ottenuto autenticandosi ad un Environment presso l’auth-service.

Parametri body:

  • timestamp
    Tipo: Data
    Formato: “1997-12-31T00:00:00.000+00:00”
    Obbligatorio: sì
    Data e orario del campionamento; la data e l’orario fanno riferimento all’UTC (Universal Time Coordinated).
  • value
    Tipo: Numerico
    Obbligatorio: si
    Valore campionato.

Risultato atteso: 201

  • id
    Identificativo del campionamento effettuato.

GET /airHumidity/latest

Header richiesti:

  • token
    Farmer token ottenuto autenticandosi con un account Farmer presso l’auth-service.

Risultato atteso: 200

  • timestamp
    Data e orario del campionamento; la data e l’orario fanno riferimento all’UTC (Universal Time Coordinated).
    Formato: “1997-12-31T00:00:00.000+00:00”

  • value
    Valore campionato.

GET /airHumidity/list

Header richiesti:

  • token
    Farmer token ottenuto autenticandosi con un account Farmer presso l’auth-service.

Parametri query:

  • id
    Tipo: Stringa
    Obbligatorio: sì
    Id dell’Environment (ottenuto dall’auth-service) della quale si vuole ottenere la lista di campionamenti.

Risultato atteso: 200

  • list
    Lista ordinata (dal più vecchio al più recente) di campionamenti dell’umidità dell’aria effettuati per il Setting specificato.