diff --git a/atom.xml b/atom.xml index 4ea3d6b376..474f01d259 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index ba643cd89f..d35bca12da 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 66031333d6..61ba722932 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index d0bbbaabfc..a5efedfe82 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index b67a7cca9e..721d0e26ef 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index e37e18cf12..32841082f9 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index f01f6afb3b..74513e632f 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 50dc6be011..330c4fcdbb 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 17cc09f8c7..d3f5094d07 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 80ab36e1d4..51c0e62f3e 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index caab63bcb7..c6777d60c4 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index c5c361ae71..8c3b2e0ec5 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 524b660dfe..9daa4d8395 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 54dbbaaf87..f198960790 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 196becb54c..99a297a719 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index b17145980a..300cf4dd1a 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index a32438b78d..fe0b53087a 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index d397fb300e..cdad3705e5 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index ce674e8e08..b907a4ecec 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 1a45e1c201..eb68678977 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 91f2f2f9b4..daa2b75c51 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-10-30T11:33:18+00:00 + 2016-10-30T15:03:51+00:00 https://home-assistant.io/ diff --git a/components/binary_sensor.rest/index.html b/components/binary_sensor.rest/index.html index bdf77c3bbd..63275f297a 100644 --- a/components/binary_sensor.rest/index.html +++ b/components/binary_sensor.rest/index.html @@ -133,10 +133,14 @@
  • value_template (Optional): Defines a template to extract the value.
  • payload (Optional): The payload to send with a POST request. Usualy formed as a dictionary.
  • verify_ssl (Optional): Verify the certification of the endpoint. Default to True.
  • +
  • authentication (Optional): Type of the HTTP authentication. basic or digest.
  • +
  • username (Optional): The username for accessing the REST endpoint.
  • +
  • password (Optional): The password for accessing the REST endpoint.
  • +
  • headers (Optional): The headers for the requests.
  • -Make sure that the URL matches exactly your endpoint or resource. +Make sure that the URL exactly matches your endpoint or resource.

    Examples

    @@ -145,7 +149,7 @@ Make sure that the URL matches exactly your endpoint or resource.

    aREST sensor

    -

    Instead of using an aREST binary sensor could the value of a device supporting aREST directly retrieved with a REST binary sensor.

    +

    Instead of using an aREST binary sensor, you could retrieve the value of a device supporting aREST directly with a REST binary sensor.

    binary_sensor:
       - platform: rest
    @@ -153,10 +157,35 @@ Make sure that the URL matches exactly your endpoint or resource.
         method: GET
         name: Light
         sensor_class: light
    -    value_template: ''
    +    value_template: '{{ value_json.return_value }}'
     
    +

    Accessing an HTTP authentication protected endpoint

    + +

    The REST sensor supports HTTP authentication and customized headers.

    + +
    binary_sensor:
    +  - platform: rest
    +    resource: http://IP_ADDRESS:5000/binary_sensor
    +    username: ha1
    +    password: test1
    +    authentication: basic
    +    headers:
    +      User-Agent: Home Assistant
    +      Content-Type: application/json
    +
    +
    + +

    The headers will contain all relevant details. This will also give you the ability to access endpoints that are protected by tokens.

    + +

    ```bash +Content-Length: 1024 +Host: IP_ADDRESS1:5000 +Authorization: Basic aGExOnRlc3Qx +Accept-Encoding: identity +Content-Type: application/json +User-Agent: Home Assistant

    diff --git a/components/sensor.rest/index.html b/components/sensor.rest/index.html index 38ec1d6dcf..ae180d01dc 100644 --- a/components/sensor.rest/index.html +++ b/components/sensor.rest/index.html @@ -129,10 +129,10 @@

    -Make sure that the URL matches exactly your endpoint or resource. +Make sure that the URL exactly matches your endpoint or resource.

    -

    curl could help you with the identification of the variable you want to display in your Home Assistant frontend. The example below show the JSON response of a device that is running with aREST.

    +

    curl can help you identify the variable you want to display in your Home Assistant frontend. The example below shows the JSON response of a device that is running with aREST.

    $ curl -X GET http://192.168.1.31/temperature/
     {"temperature": 77, "id": "sensor02", "name": "livingroom", "connected": true}
    @@ -198,14 +198,14 @@ Make sure that the URL matches exactly your endpoint or resource.
         password: test1
         authentication: basic
         headers:
    -      User-agent: Home Assistant
    +      User-Agent: Home Assistant
           Content-Type: application/json
     
    -

    The header will contains all relevant details. This will give you the flexibility to access also endpoints wich are protected by Tokens.

    +

    The headers will contain all relevant details. This will also give you the ability to access endpoints that are protected by tokens.

    -
    Content-Length: 
    +
    Content-Length: 1024
     Host: IP_ADDRESS1:5000
     Authorization: Basic aGExOnRlc3Qx
     Accept-Encoding: identity
    @@ -216,7 +216,7 @@ User-Agent: Home Assistant
     
     

    Use GitHub to get the latest release of Home Assistant

    -

    This sample is very similar to the updater component but the information are recieved from GitHub.

    +

    This sample is very similar to the updater component but the information is recieved from GitHub.

    sensor:
       - platform: rest
    diff --git a/sitemap.xml b/sitemap.xml
    index 844fff6e3b..9b12b6a96b 100644
    --- a/sitemap.xml
    +++ b/sitemap.xml
    @@ -2308,62 +2308,62 @@
     
     
     https://home-assistant.io/demo/frontend.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/index.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-event.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-info.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-service.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-state.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-template.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-history.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-iframe.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-logbook.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-map.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/googlef4f3693c209fe788.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00
     
     
     https://home-assistant.io/static/mdi-demo.html
    -2016-10-30T11:32:27+00:00
    +2016-10-30T15:02:58+00:00