mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
Withings: add note that failing URL test is expected during setup (#34948)
* Withings: add note that failing URL test is expected during setup * add prereqs * Tweaks
This commit is contained in:
parent
518bc6b59f
commit
334b29799e
@ -21,23 +21,36 @@ ha_quality_scale: platinum
|
|||||||
|
|
||||||
The **Withings** {% term integration %} consumes data from various health products produced by [Withings](https://www.withings.com).
|
The **Withings** {% term integration %} consumes data from various health products produced by [Withings](https://www.withings.com).
|
||||||
|
|
||||||
## Create a Withings developer account
|
## Prerequisites
|
||||||
|
|
||||||
You must have a developer account to distribute the data. [Create a free developer account](https://account.withings.com/partner/add_oauth2).
|
- Withings account
|
||||||
|
- Withings app installed
|
||||||
|
- Withings device setup in the app
|
||||||
|
- [Withings developer account](#create-a-withings-developer-account) to get a *ClientID* and *Secret* to connect to be able to get the data from the Withings cloud API
|
||||||
|
|
||||||
Create an application:
|
### Creating a Withings developer account
|
||||||
1. Ensure you have selected *Withings public cloud* (instead of Withings US medical cloud)
|
|
||||||
2. Create an application
|
|
||||||
3. Application creation: Public API integration
|
|
||||||
- Read and accept the terms if you're happy by pressing **Next**
|
|
||||||
4. Information:
|
|
||||||
- Target environment: *Development*
|
|
||||||
- Application name: [any name]
|
|
||||||
- Application description: [any description]
|
|
||||||
- Registered URLs: `https://my.home-assistant.io/redirect/oauth`
|
|
||||||
- Change logo: Optional.
|
|
||||||
|
|
||||||
Once saved, the *ClientID* and *Secret* fields will be populated. You will need these in the next step.
|
You must have a developer account to distribute the data.
|
||||||
|
|
||||||
|
{% note %}
|
||||||
|
You only need one developer account. The same account and credentials are used for each Withings configuration.
|
||||||
|
{% endnote %}
|
||||||
|
|
||||||
|
1. [Create a free developer account](https://account.withings.com/partner/add_oauth2).
|
||||||
|
2. Make sure to select **Withings public cloud** (and not Withings US medical cloud or similar).
|
||||||
|
3. Select **Create an application**.
|
||||||
|
4. Under **Application creation**, select **Public API integration**.
|
||||||
|
- Read and accept the terms and select **Next**.
|
||||||
|
5. Under **Information**:
|
||||||
|
- **Target environment**: *Development*
|
||||||
|
- **Application name**: [any name]
|
||||||
|
- **Application description**: [any description]
|
||||||
|
- **Registered URLs**: `https://my.home-assistant.io/redirect/oauth`
|
||||||
|
- Do not test this URL. It won't work at this stage. It will be setup once you install the integration in Home Assistant.
|
||||||
|
- **Change logo**: Optional
|
||||||
|
6. **Save** your changes.
|
||||||
|
- Once saved, the *ClientID* and *Secret* fields will be populated.
|
||||||
|
- Copy and store them in a save place. You will need these in the next step.
|
||||||
|
|
||||||
{% details "I have manually disabled My Home Assistant" %}
|
{% details "I have manually disabled My Home Assistant" %}
|
||||||
|
|
||||||
@ -51,14 +64,12 @@ authentication process.
|
|||||||
Withings will validate (with HTTP HEAD) these requirements each time you save your Withings developer account. When these checks fail, the Withings UI is not always clear about why.
|
Withings will validate (with HTTP HEAD) these requirements each time you save your Withings developer account. When these checks fail, the Withings UI is not always clear about why.
|
||||||
|
|
||||||
- Home Assistant (For create/update of Withings developer account):
|
- Home Assistant (For create/update of Withings developer account):
|
||||||
- Publicly accessible.
|
- Publicly accessible.
|
||||||
- Running on a fully qualified domain name.
|
- Running on a fully qualified domain name.
|
||||||
- Running over HTTPS signed by a globally recognized Certificate Authority. Let's Encrypt will work.
|
- Running over HTTPS signed by a globally recognized Certificate Authority. Let's Encrypt will work.
|
||||||
|
|
||||||
{% enddetails %}
|
{% enddetails %}
|
||||||
|
|
||||||
Note: You will only need one developer account; the same account and credentials are used for each Withings configuration.
|
|
||||||
|
|
||||||
{% include integrations/config_flow.md %}
|
{% include integrations/config_flow.md %}
|
||||||
|
|
||||||
## Data updates
|
## Data updates
|
||||||
|
Loading…
x
Reference in New Issue
Block a user