Enum CkanError 

pub enum CkanError {
    RequestError(Box<dyn Error + Send + Sync>),
    ParseError(Error),
    ApiError {
        status: u16,
        message: String,
    },
}

Errors that can occur when interacting with the CKAN API

This enum provides detailed error information for different types of failures that can occur during CKAN API operations.

Examples

match some_api_call().await {
    Ok(result) => println!("Success: {:?}", result),
    Err(CkanError::RequestError(e)) => {
        eprintln!("Network or HTTP error: {}", e);
    },
    Err(CkanError::ParseError(e)) => {
        eprintln!("Failed to parse API response: {}", e);
    },
    Err(CkanError::ApiError { status, message }) => {
        eprintln!("CKAN API returned error {}: {}", status, message);
    }
}

Variants

RequestError(Box<dyn Error + Send + Sync>)

Network, HTTP, or other request-level errors

This includes connection failures, timeouts, DNS resolution issues, and HTTP protocol errors (like 500 Internal Server Error).

ParseError(Error)

JSON parsing or deserialization errors

Occurs when the CKAN API returns data that doesn’t match expected schema, invalid JSON, or when response format has changed.

ApiError

CKAN-specific API errors with status codes

These are semantic errors from CKAN itself, like:

• 404: Dataset not found
• 403: Insufficient permissions
• 400: Invalid parameters
• 409: Resource conflicts

Fields

status: u16

HTTP status code from the CKAN API

message: String

Human-readable error message from CKAN

Trait Implementations

impl Debug for CkanError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CkanError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for CkanError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.