mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-04 18:18:58 +00:00
aae4f08290
The `api_password` config key has been completely removed from Home Assistant Core, therefore this warning is no longer relevant.
33 lines
979 B
Markdown
33 lines
979 B
Markdown
---
|
|
title: Home Assistant WebSocket API
|
|
description: Instructions on how to setup the WebSocket API within Home Assistant.
|
|
ha_category:
|
|
- Other
|
|
ha_release: 0.34
|
|
ha_quality_scale: internal
|
|
ha_codeowners:
|
|
- '@home-assistant/core'
|
|
ha_domain: websocket_api
|
|
---
|
|
|
|
The `websocket_api` integration set up a WebSocket API and allows one to interact with a Home Assistant instance that is running headless. This integration depends on the [`http` component](/integrations/http/).
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
websocket_api:
|
|
```
|
|
|
|
For details to use the WebSocket API, please refer to the [WebSocket API documentation](https://developers.home-assistant.io/docs/api/websocket) .
|
|
|
|
## Track current connections
|
|
|
|
The websocket API provides a sensor that will keep track of the number of current connected clients. You can add it by adding the following to your configuration:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
platform: websocket_api
|
|
```
|