Errors and Retries

All SDK errors inherit from DalyAPIError.

Exception Mapping

HTTP condition	Exception
`401`	`AuthenticationError`
`403`	`ForbiddenError`
`404`	`NotFoundError`
`409`	`ConflictError`
`400` / `422`	`ValidationError`
`429`	`RateLimitError`
`5xx`	`ServerError`
request timeout	`TimeoutError`
other non-2xx	`DalyAPIError`

Retry Semantics

The SDK does not do general automatic retries.
It retries once only for 401 after token invalidation/refresh.
Caller-managed retries are recommended for 429, transient 5xx, and timeouts.

Rate-Limit Support

RateLimitError includes retry_after when API returns Retry-After header.

Timeout Semantics

SDK wraps httpx timeout exceptions into TimeoutError with:

status_code = 0
consistent DalyAPIError inheritance for unified exception handling

Suggested Catch Pattern

from dalysdk import DalyAPIError, ValidationError, RateLimitError

try:
    result = client.energy_models.create(payload, timeout=120)
except ValidationError as exc:
    print("Input issue:", exc.detail)
except RateLimitError as exc:
    print("Rate limited; retry after:", exc.retry_after)
except DalyAPIError as exc:
    print(f"API error [{exc.status_code}] {exc.detail}")