volvo-api-core/com.github.ayastrebov.volvo.api.exception

Package-level declarations

Exception hierarchy for handling Volvo API errors with typed exceptions for rate limiting (429), authentication (401), permissions (403), invalid requests (400/404/409/415), and server errors (5xx).

Types

AuthenticationException

class AuthenticationException(statusCode: Int, error: VolvoApiError, throwable: Throwable? = null) : VolvoAPIException

Exception thrown when the access token is invalid or expired (HTTP 401).

GenericIOException

class GenericIOException(throwable: Throwable? = null) : VolvoIOException

Exception thrown for network I/O errors other than timeouts.

InvalidRequestException

class InvalidRequestException(statusCode: Int, error: VolvoApiError, throwable: Throwable? = null) : VolvoAPIException

Exception thrown for invalid or malformed API requests (HTTP 400, 404, 409, 415).

PermissionException

class PermissionException(statusCode: Int, error: VolvoApiError, throwable: Throwable? = null) : VolvoAPIException

Exception thrown when the API key lacks required permissions (HTTP 403).

RateLimitException

class RateLimitException(statusCode: Int, error: VolvoApiError, throwable: Throwable? = null) : VolvoAPIException

Exception thrown when the API rate limit is exceeded (HTTP 429).

UnknownException

class UnknownException(statusCode: Int, error: VolvoApiError, throwable: Throwable? = null) : VolvoAPIException

Exception thrown for API errors not covered by other exception types.

VolvoApiError

@Serializable

data class VolvoApiError(val detail: VolvoErrorDetails? = null)

Represents an error response from the Volvo API.

VolvoAPIException

sealed class VolvoAPIException : VolvoException

Exception thrown when the Volvo API returns an HTTP error response.

VolvoErrorDetails

@Serializable

data class VolvoErrorDetails(val code: String? = null, val message: String? = null, val param: String? = null, val type: String? = null, val line: Int? = null)

Represents an error object returned by the Volvo API.

VolvoException

sealed class VolvoException : RuntimeException

Base exception for all Volvo API client errors.

VolvoHttpException

class VolvoHttpException(throwable: Throwable? = null) : VolvoException

Exception thrown when the Ktor HTTP client encounters a runtime error.

VolvoIOException

sealed class VolvoIOException : VolvoException

Exception thrown when a network or I/O error occurs during an API request.

VolvoServerException

class VolvoServerException(throwable: Throwable? = null) : VolvoException

Exception thrown when the Volvo API returns a server error (HTTP 5xx).

VolvoTimeoutException

class VolvoTimeoutException(throwable: Throwable) : VolvoIOException

Exception thrown when an HTTP request times out.