home-assistant.io/source/_integrations/websocket_api.markdown
jamesking420 dbd192a057
Update websocket_api.markdown (#13218)
Corrected spelling of "Assistant" in the title of the page.  My first direct, if meaningless, contribution to the Home Assistant project
2020-04-30 16:19:14 +02:00

1.1 KiB

title, description, ha_category, ha_release, ha_quality_scale, ha_codeowners, ha_domain
title description ha_category ha_release ha_quality_scale ha_codeowners ha_domain
Home Assistant WebSocket API Instructions on how to setup the WebSocket API within Home Assistant.
Other
0.34 internal
@home-assistant/core
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.

It is HIGHLY recommended that you set the api_password, especially if you are planning to expose your installation to the internet.

Configuration

# Example configuration.yaml entry
websocket_api:

For details to use the WebSocket API, please refer to the WebSocket API documentation .

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:

# Example configuration.yaml entry
sensor:
  platform: websocket_api