|
8 | 8 | <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
9 | 9 | <title>Add-On Communication - Home Assistant</title>
|
10 | 10 | <meta name="author" content="Home Assistant">
|
11 |
| - <meta name="description" content="Describe internal communication Hass.io."> |
| 11 | + <meta name="description" content="Description of the internal communication of Hass.io."> |
12 | 12 | <meta name="viewport" content="width=device-width">
|
13 | 13 | <link rel="canonical" href="https://home-assistant.io/developers/hassio/addon_communication/">
|
14 | 14 | <meta property="fb:app_id" content="338291289691179">
|
15 | 15 | <meta property="og:title" content="Add-On Communication">
|
16 | 16 | <meta property="og:site_name" content="Home Assistant">
|
17 | 17 | <meta property="og:url" content="https://home-assistant.io/developers/hassio/addon_communication/">
|
18 | 18 | <meta property="og:type" content="website">
|
19 |
| - <meta property="og:description" content="Describe internal communication Hass.io."> |
| 19 | + <meta property="og:description" content="Description of the internal communication of Hass.io."> |
20 | 20 | <meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
21 | 21 | <meta name="twitter:card" content="summary_large_image">
|
22 | 22 | <meta name="twitter:site" content="@home_assistant">
|
23 | 23 | <meta name="twitter:title" content="Add-On Communication">
|
24 |
| - <meta name="twitter:description" content="Describe internal communication Hass.io."> |
| 24 | + <meta name="twitter:description" content="Description of the internal communication of Hass.io."> |
25 | 25 | <meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
|
26 | 26 | <link href="/stylesheets/screen.css" media="screen, projection, print" rel="stylesheet">
|
27 | 27 | <link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
|
@@ -74,16 +74,16 @@ <h1 class="title indent">
|
74 | 74 | </h1>
|
75 | 75 | </header>
|
76 | 76 | <hr class="divider">
|
77 |
| - <p>It exists diferent ways to communication between add-ons or home-assistant inside Home-Assistant.</p> |
| 77 | + <p>There are different ways to communication between add-ons inside Home Assistant.</p> |
78 | 78 | <h2><a class="title-link" name="network" href="#network"></a> Network</h2>
|
79 |
| -<p>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. The name have format <code class="highlighter-rouge"><span class="p">{</span><span class="err">REPO</span><span class="p">}</span><span class="err">-</span><span class="p">{</span><span class="err">SLUG</span><span class="p">}</span></code> i.e. <code class="highlighter-rouge">local-xy</code> or <code class="highlighter-rouge">3283fh-myaddon</code>.</p> |
80 |
| -<p>i.e. use <code class="highlighter-rouge">hassio</code> to speak with internal API.</p> |
81 |
| -<h2><a class="title-link" name="home-assistant" href="#home-assistant"></a> Home-Assistant</h2> |
82 |
| -<p>A Add-on can speak to <a href="https://home-assistant.io/developers/rest_api/">Home-Assistant API</a> 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: <code class="highlighter-rouge">http://hassio/homeassistant/api</code> and they will internal redirected to the right place. As next add <code class="highlighter-rouge">homeassistant_api: true</code> to <code class="highlighter-rouge">config.json</code>.</p> |
83 |
| -<p>It is also possible to speak direct to Home-Assistant instance with name <code class="highlighter-rouge">homeassistant</code> over our internal Network. But you need know the running config.</p> |
84 |
| -<p>We have severals services for Hass.io inside Home-Assistant to execute some task. So you can also use <code class="highlighter-rouge">hassio.addon_stdin</code> to send data over STDIN to a add-on.</p> |
| 79 | +<p>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 add-ons which runs on the host network are a bit limited. They can speak with all internal add-ons over their name but all other add-on can’t address the add-on in question with its name. But using an alias work well. Thus the name/alias is used to communicate inside Hass.io. The name have the following format <code class="highlighter-rouge"><span class="p">{</span><span class="err">REPO</span><span class="p">}</span><span class="err">-</span><span class="p">{</span><span class="err">SLUG</span><span class="p">}</span></code>, e.g. <code class="highlighter-rouge">local-xy</code> or <code class="highlighter-rouge">3283fh-myaddon</code>.</p> |
| 80 | +<p>Use <code class="highlighter-rouge">hassio</code> to speak with the internal API.</p> |
| 81 | +<h2><a class="title-link" name="home-assistant" href="#home-assistant"></a> Home Assistant</h2> |
| 82 | +<p>An add-on can speak to the <a href="https://home-assistant.io/developers/rest_api/">Home Assistant API</a> with our internal proxy. That makes it very easy to communicate with the API without knowing the password, port or any other information of the Home Assistant instance. Use this URL: <code class="highlighter-rouge">http://hassio/homeassistant/api</code> and internal communication is redirected to the right place. The next stept is to add <code class="highlighter-rouge">homeassistant_api: true</code> to <code class="highlighter-rouge">config.json</code>.</p> |
| 83 | +<p>It is also possible to speak direct to the Home Assistant instance which is named <code class="highlighter-rouge">homeassistant</code> over our internal network. But you need to know the configuration that is used by the running instance.</p> |
| 84 | +<p>We have severals services for Hass.io inside Home Assistant to execute tasks. To send data over STDIN to an add-on.l simply use <code class="highlighter-rouge">hassio.addon_stdin</code>.</p> |
85 | 85 | <h2><a class="title-link" name="hassio-api" href="#hassio-api"></a> Hass.io API</h2>
|
86 |
| -<p>To call to our <a href="https://github.com/home-assistant/hassio/blob/master/API.md">Hass.io API</a> add <code class="highlighter-rouge">hassio_api: true</code> to <code class="highlighter-rouge">config.json</code>. Now you can use the API over this url: <code class="highlighter-rouge">http://hassio/</code>.</p> |
| 86 | +<p>To enables calls to the <a href="https://github.com/home-assistant/hassio/blob/master/API.md">Hass.io API</a>, add <code class="highlighter-rouge">hassio_api: true</code> to <code class="highlighter-rouge">config.json</code>. Now you can use the API over the URL: <code class="highlighter-rouge">http://hassio/</code>.</p> |
87 | 87 | </article>
|
88 | 88 | </div>
|
89 | 89 | <aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
|
|
0 commit comments