mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-09 02:16:50 +00:00
Add documentation for Point oauth2 (#32971)
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
parent
95a860ccff
commit
12f1e4d90c
@ -19,44 +19,32 @@ ha_platforms:
|
|||||||
- sensor
|
- sensor
|
||||||
ha_integration_type: integration
|
ha_integration_type: integration
|
||||||
related:
|
related:
|
||||||
- docs: /docs/configuration/
|
- docs: /integrations/application_credentials/
|
||||||
title: Configuration file
|
title: Application credentials
|
||||||
---
|
---
|
||||||
|
|
||||||
The Point hub enables integration with the [Minut Point](https://minut.com/). To connect with Point, you will have to [sign up for a developer account and have a Pro subscription](https://minut.com/community/developers/) and get a `client_id` and `client_secret` with the `callback url` configured as your Home Assistant URL + `/api/minut`, e.g., `http://homeassistant.local:8123/api/minut`. The `client_id` and `client_secret` should be used as below.
|
The Point hub enables integration with the [Minut Point](https://minut.com/).
|
||||||
|
|
||||||
Once Home Assistant is started, a configurator will pop up asking you to Authenticate your Point account via a link. When you follow the link and click on **Accept** you will be redirected to the `callback url` and the Point integration will be automatically configured and you can go back to the original dialog and press **Submit**.
|
|
||||||
|
|
||||||
There is currently support for the following device types within Home Assistant:
|
## Prerequisites
|
||||||
|
|
||||||
- [Alarm](#alarm)
|
Before adding the integration to Home Assistant, you need to get Minut Point application credentials.
|
||||||
- [Binary sensor](#binary-sensor)
|
|
||||||
- [Sensor](#sensor)
|
|
||||||
|
|
||||||
### Configuration
|
1. Navigate to the [API-client | Minut](https://web.minut.com/settings/api-clients) dashboard and **Create client**:
|
||||||
|
|
||||||
To use the Minut Point {% term integration %} in your installation, add it to your {% term "`configuration.yaml`" %} file.
|
- Enter a **Name** for your client (this is just an identifier).
|
||||||
{% include integrations/restart_ha_after_config_inclusion.md %}
|
- Enter `https://my.home-assistant.io/redirect/oauth` in the **Redirect URI** field.
|
||||||
|
2. Get the **ClientID** and **ClientSecret** for the new client and store them in a safe place. You need them to complete the integration setup in Home Assistant.
|
||||||
|
|
||||||
```yaml
|
<div class='note'>
|
||||||
# Example configuration.yaml entry
|
|
||||||
point:
|
|
||||||
client_id: CLIENT_ID
|
|
||||||
client_secret: CLIENT_SECRET
|
|
||||||
```
|
|
||||||
|
|
||||||
{% configuration %}
|
If you are a Kickstarter backer, you need to send an email to hello@minut.com to retrieve the **ClientID** and **ClientSecret**. Don't forget to mention that the **Redirect URI** should be `https://my.home-assistant.io/redirect/oauth`.
|
||||||
client_id:
|
|
||||||
description: Your Minut Point developer client ID.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
client_secret:
|
|
||||||
description: Your Minut Point developer client secret.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
{% endconfiguration %}
|
|
||||||
|
|
||||||
# Device types
|
</div>
|
||||||
|
|
||||||
|
{% include integrations/config_flow.md %}
|
||||||
|
|
||||||
|
## Device types
|
||||||
|
|
||||||
The integration supports the following device types within Home Assistant:
|
The integration supports the following device types within Home Assistant:
|
||||||
- [Alarm](#alarm)
|
- [Alarm](#alarm)
|
||||||
|
Loading…
x
Reference in New Issue
Block a user