From 4b2832f8caba1dcb581cc9abb8828fdd6d8d807d Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Thu, 24 Sep 2015 15:14:27 +0200
Subject: [PATCH] Add two examples

---
 source/components/sensor.rest.markdown | 34 ++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/source/components/sensor.rest.markdown b/source/components/sensor.rest.markdown
index 5eb622bec58..81433c677ba 100644
--- a/source/components/sensor.rest.markdown
+++ b/source/components/sensor.rest.markdown
@@ -65,4 +65,38 @@ $ curl -X GET http://192.168.1.31/temperature/
 {"temperature": 77, "id": "sensor02", "name": "livingroom", "connected": true}
 ```
 
+## {% linkable_title Examples %}
+
+In this section you find some real life examples of how to use this sensor.
+
+### {% linkable_title External IP address %}
+
+Always want to know your external IP address. [JSON Test](http://www.jsontest.com) will provide you this information at their http://ip.jsontest.com/ endpoint.
+
+To display the IP address, the entry for a sensor in the `configuration.yaml` file will look like this.
+
+```yaml
+# Example configuration.yaml entry
+  - platform: rest
+    resource: http://ip.jsontest.com
+    name: External IP
+    variable: 'ip'
+```
+
+### {% linkable_title Single value from a local Glances instance %}
+
+The [glances](/components/sensor.glances.html) sensor is doing a similar thing
+
+Add something similar to the entry below to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+  - platform: rest
+    resource: http://IP_ADRRESS:61208/api/2/mem/used
+    name: Used mem
+    variable: 'used'
+    unit_of_measurement: MB
+    correction_factor: 0.000000954
+    decimal_places: 0
+```