REST API

Some functions of JRDS can be accessed through a REST API.

• Last collected value
• Reload
• Download graph
• Download raw values

When needed, the time interval is given as cgi argument called begin and end, or scale.

scale describe a period of time ending now and starting at a default time in past:

1. Last Hour
2. Last 2 Hours
3. Last 3 Hours
4. Last 4 Hours
5. Last 6 Hours
6. Last 12 Hours
7. Last Day
8. Last 2 Days
9. Last Week
10. Last 2 Weeks
11. Last Month
12. Last 2 Months
13. Last 3 Months
14. Last 4 Months
15. Last 6 Months
16. Last Year
17. Last 2 Years

If a more precise definition is needed, a begin and a start date can be provided, using different format.

• an iso 8601 formated date YYYY-MM-DDThh:mm:ssz.
• a integer, being the number of millisecond since epoch (1, 1970, 00:00:00 GMT)

If the YYYY-MM-DD part is omitted, the currend day is used. If the hh:mm:ss part is omitted, the time is set for 00:00:00 for the begin argument and 23:59:00 for the end argument. If the seconds are omitted, they are set to 00 for the begin argument ant 59 for the end argument. If the time zone is omitted, the local time of the jrds server is used. If defined, it must be know to the jvm.

A few valid time definitions are :

• 2007-01-01
• 2007-01-01T00:00
• 1:12
• 22:58:57
• 2007-01-01T00:00:00Z
• 1302021873193