RESTful Switch

The rest switch platform allows you to control a given endpoint that supports a RESTful API. The switch can get the state via GET and set the state via POST on a given REST resource.

To enable this switch, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: rest
    resource: http://IP_ADDRESS/ENDPOINT

Configuration variables:

  • resource (Required): The resource or endpoint that contains the value.
  • name (Optional): Name of the REST switch.
  • body_on (Optional): The body that represents enabled state. Default is “ON”.
  • body_off (Optional):The body that represents disabled state. Default is “OFF”.

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