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.7.2

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.7.2
File Size Uploaded Provenance Actions
daikin_onecta-0.7.2.tar.gz 28.1 kB With provenance Details for daikin_onecta-0.7.2.tar.gz

Built distribution (wheel)

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

Total release size: 48.1 kB

Release files / daikin_onecta-0.7.2.tar.gz

Download URL daikin_onecta-0.7.2.tar.gz
Size 28.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8f2b3f04447622deb89dd01835a0ed2274ed27eb66ce0c1199424b51d0d1631f
BLAKE2b-256 checksum
How to use checksums
cc087b1796a6c9e588356ad4b72ecc6d42573a328fadee1a67ae6d5f4c658f35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 21, 2026.

Transparency log

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

Download URL daikin_onecta-0.7.2-py3-none-any.whl
Size 20.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
63512ee405d0a8b8ac06d5dd6131eab52325988e2a1e17807a56a85ca04a4dcf
BLAKE2b-256 checksum
How to use checksums
2e4b9b4f8e3e7fa4b29906da9b0e3b0505d42f3aaaec6d55c1418c432faa5b09
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 21, 2026.

Transparency log

Security for daikin-onecta 0.7.2

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.7.2.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 Nov 21, 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