diff --git a/atom.xml b/atom.xml index 87786beb7c..adbaf61b91 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@
-Events are saved in a local database. Google Graphs is used to draw the graph. Drawing is happening 100% in your browser - no data is transferred to anyone at any time. +Events are saved in a local database. Google Graphs is used to draw the graph. Drawing is happening 100% in your browser. No data is transferred to anyone at any time.
The history is stored in a SQLite databse home-assistant.db
within your config directory.
The history is stored in a SQLite database home-assistant.db
within your config directory.
time_changed
that happened while recorder component was running.new_state
values of state_changed
events.entity_id
: the entity_id of the entitystate
: the state of the entityattributes
: JSON of the state attributeslast_changed
: timestamp last time the state has changed. A state_changed event can happen when just attributes change.last_updated
: timestamp anything has changed (state, attributes)created
: timestamp this entry was inserted into the databaseThe history information are also available through the RESTful API.
+ diff --git a/developers/rest_api/index.html b/developers/rest_api/index.html index 00a291051f..1ba005e456 100644 --- a/developers/rest_api/index.html +++ b/developers/rest_api/index.html @@ -297,6 +297,52 @@ You can append?api_password=YOUR_PASSWORD
to any url to log in aut
+Returns an array of state changes in the past. Each object contains further detail for the entities.
+ +[ + [ + { + "attributes": { + "friendly_name": "Weather Temperature", + "unit_of_measurement": "\u00b0C" + }, + "entity_id": "sensor.weather_temperature", + "last_changed": "23:30:00 05-02-2016", + "last_updated": "23:30:00 05-02-2016", + "state": "-3.9" + }, + { + "attributes": { + "friendly_name": "Weather Temperature", + "unit_of_measurement": "\u00b0C" + }, + "entity_id": "sensor.weather_temperature", + "last_changed": "07:03:30 06-02-2016", + "last_updated": "07:03:30 06-02-2016", + "state": "-1.9" + }, + ] +] +
Sample curl
commands:
$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" http://localhost:8123/api/history/period/2016-02-06 +
$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" http://localhost:8123/api/history/period/2016-02-06?filter_entity_id=sensor.temperature +
Returns an array of state objects. Each state has the following attributes: entity_id, state, last_changed and attributes.
diff --git a/sitemap.xml b/sitemap.xml index 00b002ffeb..06f4948767 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1018,618 +1018,618 @@