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.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.7.1
File Size Uploaded Provenance Actions
daikin_onecta-0.7.1.tar.gz 27.6 kB With provenance Details for daikin_onecta-0.7.1.tar.gz

Built distribution (wheel)

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

Total release size: 47.5 kB

Release files / daikin_onecta-0.7.1.tar.gz

Download URL daikin_onecta-0.7.1.tar.gz
Size 27.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a35c67f9ade40b84d6d044f4d382c1874996405b769d9306ea583e6ab31324ca
BLAKE2b-256 checksum
How to use checksums
65c45dbea9c81ef08acbb96891af3d552bc8ea8f53933a5d3aa668781772d551
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.1-py3-none-any.whl

Download URL daikin_onecta-0.7.1-py3-none-any.whl
Size 19.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ee48d67dfd066151d436c4a0deed0a64b15dff7eed1b8bec228078f8cf80ab33
BLAKE2b-256 checksum
How to use checksums
c9d582c8b81b4d480c7b2a238143af6ea578bff2160bc25402d924cf659779cb
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.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.7.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 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