openbankproject_client.errors module

Error handling utilities for the OpenBankProject API Client.

exception openbankproject_client.errors.ApiError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: Exception

Base exception for OpenBankProject API errors.

__init__(message: str, status_code: int | None = None, detail: Dict | None = None)

Initialize the exception.

Parameters:

• message – Error message

• status_code – HTTP status code (if applicable)

• detail – Additional error details

__str__() → str

Return string representation of the error.

exception openbankproject_client.errors.AuthenticationError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised for authentication errors.

exception openbankproject_client.errors.ResourceNotFoundError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised when a resource is not found.

exception openbankproject_client.errors.ValidationError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised for validation errors.

exception openbankproject_client.errors.PermissionError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised for permission errors.

exception openbankproject_client.errors.RateLimitError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised when rate limit is exceeded.

exception openbankproject_client.errors.ServerError(message: str, status_code: int | None = None, detail: Dict | None = None)

Bases: ApiError

Exception raised for server errors.

class openbankproject_client.errors.ErrorHandler

Bases: object

Utility class for handling API errors.

static handle_error_response(response: Any) → None

Handle error responses from the API.

Parameters:

response – Response object from requests library

Raises:

• AuthenticationError – For authentication errors (401)

• PermissionError – For permission errors (403)

• ResourceNotFoundError – For not found errors (404)

• ValidationError – For validation errors (400)

• RateLimitError – For rate limit errors (429)

• ServerError – For server errors (5xx)

• ApiError – For other errors