jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 01:06:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add OpenUV docs that describe the 403/re-auth idiosyncrasy (#25671)

Browse Source
This commit is contained in:
Aaron Bach 2023-01-12 12:38:42 -07:00 committed by GitHub
parent 44b92739ae
commit 13767f0cfd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_integrations/openuv.markdown
View File

@ -174,3 +174,23 @@ automation:
- sensor.LATITUDE_LONGITUDE_current_uv_index
```
{% endraw %}
## Expired API Keys and Re-authentication
In OpenUV, an `HTTP 403` response indicates one of two conditions:
1. An invalid API key
2. An API key whose daily/monthly limit is reached
Unfortunately, the integration is unable to determine which is which from the API data
provided by OpenUV. So, this strategy is followed:
1. Any `HTTP 403` response will create a persistent notification asking you to
re-authenticate the OpenUV integration.
2. In the case of an overrun API call limit, once the `homeassistant.update_entity`
service call is again successful, existing re-authentication notifications will
automatically be removed.
If you receive a re-authentication notification and are certain that your key has merely
reached its daily call limit, you can safely ignore it.