Cannot connect to api.hella.link - Local API configuration needed

[mattoo22]

Environment

Installation method: Home Assistant OS
Core: 2025.9.4
Supervisor: 2025.09.0
Operating System: 16.2
Frontend: 20250903.5
Integration Version: v11.1.0
ONYX.CENTER 2.0.0
Protocol version: 7.12.0
App version: 2.6-697
OS Version: 2.8.1-0-g440bfb0

Problem Description
The integration fails to connect during setup with the following error:
aiohttp.client_exceptions.ClientConnectorError: Cannot connect to host api.hella.link:443 ssl:default [None]
The integration attempts to connect to HELLA's cloud API server (api.hella.link) but fails due to SSL/connection issues. This appears to be a server-side issue as the HELLA API server is currently unreachable.

Current Setup
Local API is accessible and working (tested with curl)
Have valid API code, fingerprint, and access token from local authorization

Local API Verification
I can successfully access the local API directly:
bashcurl -k -H "Authorization: Bearer [token]" https://x.x.x.x/api/v3/devices
This returns my 5 ONYX devices correctly.

Request
Could you please add support for local API configuration in the integration setup? According to the ONYX API documentation, local API access is supported starting with firmware 2.4 and API v3.

Suggested Solutions:
Add a configuration option to specify local ONYX.CENTER IP address instead of using api.hella.link
Add fallback mechanism - try local API if cloud API fails
Add YAML configuration support for local API setup

Logs
Error handling request from 192.168.x.x
Traceback (most recent call last):
File "/usr/local/lib/python3.13/site-packages/aiohttp/connector.py", line 1283, in _wrap_create_connection
return await self._loop.create_connection(*args, **kwargs, sock=sock)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[... SSL connection error to api.hella.link ...]

aiohttp.client_exceptions.ClientConnectorError: Cannot connect to host api.hella.link:443 ssl:default [None]

Do you have a workaround for this?

Thank you for this great integration!

[muhlba91]

thanks for raising this - #273 is the parent issue for this as i planned to integrate local API access at some point.

i started working on this extension but was wondering if you have a particular reasoning behind Add fallback mechanism - try local API if cloud API fails?
my plan is to always use the local API if a user specifies a local IP address with the following reasoning: if someone specifies an IP address (which has to be static anyway), there's no reason to even try querying the public API. we will always have local API access.

[muhlba91]

this feature is implemented on the current main branch. i plan to draft the release in the coming days but you can try it out by using the main branch to provide feedback.