API r5

Routes

batch/:guid [PUT]
channel/:guid/:attribute [GET]
channel/:guid/parent(/:attribute) [GET]
channel/:guid [GET]
channel/:id [DELETE]
channels [GET]
csv/:guid [PUT]
data/:guid(/:p1(/:p2)) [GET]
data/:guid/:timestamp [DELETE]
data/:guid [POST]
data/:guid [PUT]
data/raw/:guid [PUT]
daylight(/:offset) [GET]
daylight/:latitude/:longitude(/:offset) [GET]
hash [GET|POST]
help [ANY]
helphtml [ANY]
json/:path+ [GET]
json/:path+ [POST]
jsonencode [POST]
log/:id [DELETE]
log/:id [GET]
log/:id [POST]
log/all(/:page(/:count)) [GET]
log [PUT]
ping [GET]
status [GET]
sunrise(/:date) [GET]
sunrise/:latitude/:longitude(/:date) [GET]
sunset(/:date) [GET]
sunset/:latitude/:longitude(/:date) [GET]
tariff/:id/:date [GET]
tariff/:id/time/:date(/:to) [GET]
tariff/:id [GET]
tariff [GET]
time(/:format) [GET]
translation [GET]
tree/:id [DELETE]
tree/alias/:id [PUT]
view/:slug [DELETE]
view/:slug [GET]
view/:slug [POST]
view [PUT]
views(/:language) [GET]

[PUT] /api/r5/batch/:guid ^

Save multiple reading values

• API key required: yes
• Available since: r2

Header

X-PVLng-CSV-RecordSeparator

Set record separator (if not semicolon) since r5, "TAB" as string will be also accepted

X-PVLng-CSV-Separator

Set data separator (if not comma) since r5, "TAB" as string will be also accepted

Payload

<timestamp>,<value>;...

timestamp and value data sets

<date time>,<value>;...

date time and value data sets

<date>,<time>,<value>;...

date, time and value data sets

[GET] /api/r5/channel/:guid/:attribute ^

Fetch all channel attributes or specific channel attribute

• API key required: yes
• Available since: r3

[GET] /api/r5/channel/:guid/parent(/:attribute) ^

Fetch all attributes or a specific attribute from parent channel

• API key required: yes
• Available since: r4

[GET] /api/r5/channel/:guid ^

Fetch single channel attribute

• API key required: yes
• Available since: r3

[DELETE] /api/r5/channel/:id ^

Delete channel and its readings

• API key required: yes
• Available since: r4

[GET] /api/r5/channels ^

Fetch all channels

• API key required: yes
• Available since: r3

[PUT] /api/r5/csv/:guid ^

Save multiple reading values from CSV

• API key required: yes
• Available since: r2

Header

X-PVLng-CSV-Separator

Set data separator (if not semicolon) since r5, "TAB" as string will be also accepted

Payload

<timestamp>;<value>

timestamp and value data row(s)

<date time>;<value>

date time and value data row(s)

<date>;<time>;<value>

date, time and value data row(s)

[GET] /api/r5/data/:guid(/:p1(/:p2)) ^

Read reading values

• API key required: yes
• Available since: r2

[DELETE] /api/r5/data/:guid/:timestamp ^

Delete a reading value

• API key required: yes
• Available since: r2

[POST] /api/r5/data/:guid ^

Update a reading value, timestamp is required here

• API key required: yes
• Available since: r4

Payload

{"data":"<value>","timestamp":"<timestamp>"}

JSON encoded value

[PUT] /api/r5/data/:guid ^

Save a reading value

• API key required: yes
• Available since: r2

Payload

{"data":"<value>"}

JSON encoded value, use server time

{"data":"<value>","timestamp":"<timestamp>"}

JSON encoded value, use provided timestamp

{"data":"<value>","timestamp":"<date time>"}

JSON encoded value, use provided date and time

[PUT] /api/r5/data/raw/:guid ^

Save raw data, channel decide what to do with them

• API key required: yes
• Available since: r4

Payload

raw data in any format

Channel have to handle it

[GET] /api/r5/daylight(/:offset) ^

Check for daylight for configured location, accept additional minutes before/after

• API key required: yes
• Available since: r3

[GET] /api/r5/daylight/:latitude/:longitude(/:offset) ^

Check for daylight, accept additional minutes before/after

• API key required: yes
• Available since: r3

[GET|POST] /api/r5/hash ^

Create MD5 and SHA1 hashes and a slug for the given text

• API key required: yes
• Available since: r3

[ANY] /api/r5/help ^

This help, overview of valid calls

• API key required: yes
• Available since: r1

[ANY] /api/r5/helphtml ^

This help in HTML for browsers, overview of valid calls

• API key required: yes
• Available since: r4

[GET] /api/r5/json/:path+ ^

Extract a section/value from given JSON data from query string

• API key required: yes
• Available since: r1

Payload

...json/path/to/node/?json=<JSON data>

[POST] /api/r5/json/:path+ ^

Extract a section/value from given JSON data sended in request body e.g. from a file

• API key required: yes
• Available since: r1

[POST] /api/r5/jsonencode ^

Encode posted data to JSON

• API key required: yes
• Available since: r1

[DELETE] /api/r5/log/:id ^

Delete a log entry

• API key required: yes
• Available since: r2

[GET] /api/r5/log/:id ^

Read a log entry

• API key required: yes
• Available since: r2

[POST] /api/r5/log/:id ^

Update a log entry

• API key required: yes
• Available since: r2

Payload

{"scope":"...", "message":"..."}

[GET] /api/r5/log/all(/:page(/:count)) ^

Read all log entries, paginated for :page, :count entries

• API key required: yes
• Available since: r2

[PUT] /api/r5/log ^

Store new log entry, scope defaults to 'API rr5'

• API key required: yes
• Available since: r2

Payload

{"scope":"...", "message":"..."}

[GET] /api/r5/ping ^

For new relic pinger

• API key required: yes
• Available since: r4

[GET] /api/r5/status ^

System status

• API key required: yes
• Available since: r2

[GET] /api/r5/sunrise(/:date) ^

Get sunrise of day, using configured loaction

• API key required: yes
• Available since: r3

[GET] /api/r5/sunrise/:latitude/:longitude(/:date) ^

Get sunrise for location and day

• API key required: yes
• Available since: r3

[GET] /api/r5/sunset(/:date) ^

Get sunset of day, using configured loaction

• API key required: yes
• Available since: r3

[GET] /api/r5/sunset/:latitude/:longitude(/:date) ^

Get sunset of day

• API key required: yes
• Available since: r3

[GET] /api/r5/tariff/:id/:date ^

Extract tariff for a day

• API key required: yes
• Available since: r4

[GET] /api/r5/tariff/:id/time/:date(/:to) ^

Extract tariff for a day

• API key required: yes
• Available since: r4

[GET] /api/r5/tariff/:id ^

Extract a tariff

• API key required: yes
• Available since: r4

[GET] /api/r5/tariff ^

Extract all tariffs

• API key required: yes
• Available since: r4

[GET] /api/r5/time(/:format) ^

Deliver actual server time

• API key required: yes
• Available since: r4

[GET] /api/r5/translation ^

Extract english texts for translation

• API key required: yes
• Available since: r3

[DELETE] /api/r5/tree/:id ^

Delete channel from channel hierarchy

• API key required: yes
• Available since: r4

[PUT] /api/r5/tree/alias/:id ^

Create alias from given hierarchy Id

• API key required: yes
• Available since: r4

[DELETE] /api/r5/view/:slug ^

Detele chart view data by slug

• API key required: yes
• Available since: r3

[GET] /api/r5/view/:slug ^

Fetch chart view data via slug

• API key required: yes
• Available since: r3

[POST] /api/r5/view/:slug ^

Update chart view data via slug

• API key required: yes
• Available since: r3

[PUT] /api/r5/view ^

Create chart view data, return slug

• API key required: yes
• Available since: r3

[GET] /api/r5/views(/:language) ^

Fetch all charts

• API key required: yes
• Available since: r3