Skip to main content

daikin-onecta

CI codecov PyPI version Python versions License

Async Python client for the Daikin Onecta cloud API.

This library contains the Daikin-specific API layer used by the Home Assistant Daikin Onecta integration. It deliberately has no dependency on Home Assistant.

Usage

import aiohttp

from daikin_onecta import OnectaClient


async def token_provider() -> str:
    return "access-token"


async with aiohttp.ClientSession() as session:
    client = OnectaClient(session, token_provider)
    devices = await client.get_gateway_devices()

Authentication is supplied by an asynchronous token callback so applications remain responsible for their own OAuth flow and token refresh.

Errors

Requests raise typed exceptions instead of returning error sentinel values:

  • OnectaAuthenticationError for HTTP 401 and 403 responses;
  • OnectaRateLimitError for HTTP 429 responses;
  • OnectaApiError for other unsuccessful HTTP responses;
  • OnectaResponseError when a successful response has an invalid body;
  • OnectaConnectionError for transport failures.

All request errors provide their HTTP method and relative API path. OnectaRateLimitError.rate_limit contains the immutable rate-limit snapshot returned with the rejected response, including retry_after.

Status

The API is currently alpha. The first release intentionally exposes gateway devices as raw dictionaries while the stable typed device model is developed.

Metadata

Release files for daikin-onecta 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for daikin-onecta 0.4.1
File Size Uploaded Provenance Actions
daikin_onecta-0.4.1.tar.gz 13.3 kB With provenance Details for daikin_onecta-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for daikin-onecta 0.4.1
File Interpreter ABI Platform Actions
daikin_onecta-0.4.1-py3-none-any.whl Python 3 none any Details for daikin_onecta-0.4.1-py3-none-any.whl

Total release size: 22.6 kB

Release files / daikin_onecta-0.4.1.tar.gz

Download URL daikin_onecta-0.4.1.tar.gz
Size 13.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cda389876fcf936240fbc56e59f15fa327d07de5d2fcf6cb2b3772d7f53b0302
BLAKE2b-256 checksum
How to use checksums
2bbcb6383cb4679fe16f12b2cc0ce1c927ee017496579b21a281a899385d343d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Release files / daikin_onecta-0.4.1-py3-none-any.whl

Download URL daikin_onecta-0.4.1-py3-none-any.whl
Size 9.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83914ceafb950a8ae87953f4e10f9e71dea26368f07cde77cf55f82b68834d19
BLAKE2b-256 checksum
How to use checksums
b987c2206439c25ec087166885563ea6a3a7d33cfb6135c866eb6250ba69fa29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Security for daikin-onecta 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for daikin_onecta-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page