From 69c502f1bb3e383e7c7d62d3f888db7a6139dd07 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Sun, 8 Oct 2017 22:28:12 +0200 Subject: [PATCH] Create addon_communication.markdown --- .../hassio/addon_communication.markdown | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 source/developers/hassio/addon_communication.markdown diff --git a/source/developers/hassio/addon_communication.markdown b/source/developers/hassio/addon_communication.markdown new file mode 100644 index 00000000000..8c4b7ccc5c3 --- /dev/null +++ b/source/developers/hassio/addon_communication.markdown @@ -0,0 +1,31 @@ +--- +layout: page +title: "Add-On Communication" +description: "Describe internal communication Hass.io." +date: 2017-04-30 13:28 +sidebar: true +comments: false +sharing: true +footer: true +redirect_from: /hassio/addon_config/ +--- + +It exists diferent ways to communication between add-ons or home-assistant inside Home-Assistant. + +## {% linkable_title Network %} + +We use a internal network. That allow to speak with every add-on or from Home-Assistant to add-on by name or alias. Only the a add-on they run on Host network are a bit limited. They can speak with all internal add-ons over there name but all other add-on can't speak with the add-on name to this add-on, but alias work wheel. So use the name/alias to communicate inside Hass.io + +i.e. use `hassio` to speak with internal API. + +## {% linkable_title Home-Assistant %} + +A Add-on can speak to [Home-Assistant API][hass-api] with our internal proxy. That make it very easy to speak to this API without you need know the password, port or any other information for the Home-Assistant instance. Use this url: `http://hassio/homeassistant/api` and they will internal redirected to the right place. As next add `homeassistant_api: true` to `config.json`. + +It is also possible to speak direct to Home-Assistant instance with name `homeassistant` over our internal Network. But you need know the running config. + +## {% linkable_title Hass.io API %} + + +[hass-api]: https://home-assistant.io/developers/rest_api/ +[hassio-api]: https://github.com/home-assistant/hassio/blob/master/API.md