WeConnect/rsdev.ovh.weconnect.errors/WeConnectException

WeConnectException

sealed class WeConnectException : Exception

Sealed exception hierarchy for all recoverable errors thrown by the library.

Catch specific subtypes to handle different failure modes:

AuthenticationError -- credentials rejected or session expired
RetrievalError -- data fetch failed (vehicle list, status, trips, etc.)
ControlError -- a vehicle command was rejected
TooManyRequestsError -- HTTP 429 rate limit hit
ApiError -- generic non-success HTTP response

Inheritors

AuthenticationError

TooManyRequestsError

Types

class ApiError(val statusCode: Int, val body: String, cause: Throwable? = null) : WeConnectException

Catch-all for unexpected non-success HTTP responses.

AuthenticationError

class AuthenticationError(message: String, cause: Throwable? = null) : WeConnectException

Login failed, token refresh failed, or session cannot be renewed.

class ControlError(message: String, cause: Throwable? = null) : WeConnectException

A vehicle command was rejected by the BFF API.

class RetrievalError(message: String, cause: Throwable? = null) : WeConnectException

A data retrieval call returned a non-success status.

TooManyRequestsError

class TooManyRequestsError(val retryAfterSeconds: Int? = null, cause: Throwable? = null) : WeConnectException

HTTP 429 -- the BFF API rate limit was exceeded.

Properties

open val cause: Throwable?

localizedMessage

open val localizedMessage: String?

open val message: String?

open var stackTrace: Array<out StackTraceElement?>?

val suppressed: Array<out Throwable?>?