Client for the 'ZENTRA Cloud' API

Provides functionality to read settings, statuses and readings of weather stations from the 'ZENTRA Cloud' API < https://zentracloud.com/api/v1/guide#APIGuidelines>.

rzentra

An R client for Zentracloud API.

Installation

Example

library("rzentra")

Authentcation

To work with the API you first need to authenticate. The zc_token() function authenticates you with your username and password and returns a token that can be used in subsequent API-calls.

The username & password are by default read from environmental variables ZC_USERNAME and ZC_PASSWORD, but you can provide them also in every function call using the username= and password= arguments.

token <- zc_token(username = "yourname", password = "yourpassword")$token

Querying data

Device settings

Querying the settings of a device can be done with zc_settings

zc_settings(token = token, 
  sn = "z6-00033", 
  start_time = as.numeric(as.POSIXct(Sys.Date(), origin = "1970-01-01"))
  )

Device statuses

Querying the settings of a device can be done with zc_statuses

zc_statuses(token = token, 
  sn = "z6-00033", 
  start_time = as.numeric(as.POSIXct(Sys.Date(), origin = "1970-01-01"))
  )

Device readings

zc_readings(token = token, 
  sn = "z6-00033", 
  start_time = as.numeric(as.POSIXct(Sys.Date(), origin = "1970-01-01"))
  )

Parsing data

Readings can be parsed into a long time-series table with zc_timeseries()

head(
  zc_timeseries(readings)
)