jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-14 12:56:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update rest notify component configuration (#7527)

Browse Source
This commit is contained in:
Klaas Schoute 2018-11-16 08:57:14 +01:00 committed by Fabian Affolter
parent 2cee806142
commit a15df464ad
1 changed files with 41 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
source/_components/notify.rest.markdown
View File

@ -12,7 +12,6 @@ ha_category: Notifications
ha_release: 0.13 ha_release: 0.13
--- ---
The `rest` notification platform allows you to deliver [RESTful](https://en.wikipedia.org/wiki/Representational_state_transfer) notifications from Home Assistant to another party. The `rest` notification platform allows you to deliver [RESTful](https://en.wikipedia.org/wiki/Representational_state_transfer) notifications from Home Assistant to another party.
To enable the REST notification in your installation, add the following to your `configuration.yaml` file: To enable the REST notification in your installation, add the following to your `configuration.yaml` file:
@ -25,17 +24,46 @@ notify:
resource: http://IP_ADDRESS/ENDPOINT resource: http://IP_ADDRESS/ENDPOINT
``` ```
Configuration variables: {% configuration %}
name:
- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`. description: Setting the optional parameter `name` allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`.
- **resource** (*Required*): The resource or endpoint that will receive the value. required: false
- **method** (*Optional*): The method of the request. Default is `GET`. Other valid options are `POST` or `POST_JSON`. default: notify
- **headers** (*Optional*): The headers for the request. type: string
- **message_param_name** (*Optional*): Parameter name for the message. Defaults to `message`. resource:
- **title_param_name** (*Optional*): Parameter name for the title. Defaults to none. description: The resource or endpoint that will receive the value.
- **target_param_name** (*Optional*): Parameter name for the target. Defaults to none. required: true
- **data** (*Optional*): Dictionary of extra parameters to send to the resource. type: string
- **data_template** (*Optional*): Template dictionary of extra parameters to send to the resource. method:
description: The method of the request. Valid options are `GET`, `POST` or `POST_JSON`.
required: false
default: GET
type: string
headers:
description: The headers for the request.
required: false
type: string
message_param_name:
description: Parameter name for the message.
required: false
default: message
type: string
title_param_name:
description: Parameter name for the title.
required: false
type: string
target_param_name:
description: Parameter name for the target.
required: false
type: string
data:
description: Dictionary of extra parameters to send to the resource.
required: false
type: string
data_template:
description: Template dictionary of extra parameters to send to the resource.
required: false
type: template
{% endconfiguration %}
To use notifications, please see the [getting started with automation page](/getting-started/automation/). To use notifications, please see the [getting started with automation page](/getting-started/automation/).