​

Errors and Retries

​

Exception Mapping

​

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

​

Timeout Semantics

• 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}")