mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-16 07:58:58 +00:00
1.7 KiB
1.7 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Server-sent events | Home Assistant Server-sent events documentation | 2016-04-08 07:00 | true | false | true | true |
The server-sent events feature is a one-way channel from your Home Assistant server to a client which is acting as a consumer. For bi-directional communication check the RESTful API and Python API.
The URI that is generating the data is /api/stream.
A requirement on the client-side is existing support for the EventSource interface.
There are various ways to access the stream. One is curl:
$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \
-H "Content-Type: application/json" http://localhost:8123/api/stream
For more comfort put the HTML snippet below in a file sse.html in your www folder of your Home Assistant configuration directory (.homeassistant)
<!DOCTYPE html>
<html>
<body>
<h1>Getting Home Assistant server events</h1>
<div id="events"></div>
<script type="text/javascript">
var source = new EventSource("/api/stream");
source.onmessage = function(event) {
document.getElementById("events").innerHTML += event.data + "<br>";
};
</script>
</body>
</html>
Visit http://localhost:8123/local/sse.html to see the stream of events.
{% linkable_title Example %}
The home-assistant-sse repository contains an more advanced example.