Enum FilesError 

pub enum FilesError {
    Request(Error),
    BadRequest {
        message: String,
        field: Option<String>,
    },
    AuthenticationFailed {
        message: String,
        auth_type: Option<String>,
    },
    Forbidden {
        message: String,
        resource: Option<String>,
    },
    NotFound {
        message: String,
        resource_type: Option<String>,
        path: Option<String>,
    },
    Conflict {
        message: String,
        resource: Option<String>,
    },
    PreconditionFailed {
        message: String,
        condition: Option<String>,
    },
    UnprocessableEntity {
        message: String,
        field: Option<String>,
        value: Option<String>,
    },
    Locked {
        message: String,
        resource: Option<String>,
    },
    RateLimited {
        message: String,
        retry_after: Option<u64>,
    },
    InternalServerError {
        message: String,
        request_id: Option<String>,
    },
    ServiceUnavailable {
        message: String,
        retry_after: Option<u64>,
    },
    ApiError {
        code: u16,
        message: String,
        endpoint: Option<String>,
    },
    ConfigError(String),
    JsonError(Error),
    JsonPathError {
        path: String,
        source: Error,
    },
    IoError(String),
    UrlParseError(ParseError),
}

Errors that can occur when using the Files.com API

Each error variant includes contextual information to help with debugging and provide meaningful error messages to users.

Variants

Request(Error)

HTTP request failed

BadRequest

Bad Request (400) - Invalid parameters or malformed request

Fields

message: String

field: Option<String>

Optional field that caused the error

AuthenticationFailed

Authentication failed (401)

Fields

message: String

auth_type: Option<String>

The authentication method that failed

Forbidden

Forbidden (403) - Valid credentials but insufficient permissions

Fields

message: String

resource: Option<String>

The resource that was forbidden

NotFound

Not Found (404) - Resource does not exist

Fields

message: String

resource_type: Option<String>

Type of resource (e.g., “file”, “folder”, “user”)

path: Option<String>

Path or identifier of the resource

Conflict

Conflict (409) - Resource already exists or state conflict

Fields

message: String

resource: Option<String>

The conflicting resource path or identifier

PreconditionFailed

Precondition Failed (412) - Conditional request failed

Fields

message: String

condition: Option<String>

The condition that failed

UnprocessableEntity

Unprocessable Entity (422) - Validation error

Fields

message: String

field: Option<String>

Field that failed validation

value: Option<String>

The invalid value provided

Locked

Locked (423) - Resource is locked

Fields

message: String

resource: Option<String>

The locked resource

RateLimited

Rate Limited (429) - Too many requests

Fields

message: String

retry_after: Option<u64>

Seconds until retry is allowed

InternalServerError

Internal Server Error (500)

Fields

message: String

request_id: Option<String>

Request ID for support purposes

ServiceUnavailable

Service Unavailable (503)

Fields

message: String

retry_after: Option<u64>

Seconds until service might be available

ApiError

Generic API error with status code

Fields

code: u16

message: String

endpoint: Option<String>

The endpoint that returned the error

ConfigError(String)

Configuration error

JsonError(Error)

JSON serialization/deserialization error

JsonPathError

JSON deserialization error with path information

Fields

path: String

source: Error

IoError(String)

I/O error (file operations)

UrlParseError(ParseError)

URL parsing error

Implementations

impl FilesError

pub fn not_found(message: impl Into<String>) -> Self

Create a NotFound error with context

pub fn not_found_resource( message: impl Into<String>, resource_type: impl Into<String>, path: impl Into<String>, ) -> Self

Create a NotFound error for a specific resource type

pub fn bad_request(message: impl Into<String>) -> Self

Create a BadRequest error with optional field context

pub fn bad_request_field( message: impl Into<String>, field: impl Into<String>, ) -> Self

Create a BadRequest error with field context

pub fn validation_failed( message: impl Into<String>, field: impl Into<String>, value: impl Into<String>, ) -> Self

Create an UnprocessableEntity error with validation context

pub fn rate_limited( message: impl Into<String>, retry_after: Option<u64>, ) -> Self

Create a RateLimited error with retry-after context

pub fn with_resource_type(self, resource_type: impl Into<String>) -> Self

Add resource context to a NotFound error

pub fn with_path(self, path: impl Into<String>) -> Self

Add path context to a NotFound error

pub fn with_field(self, field: impl Into<String>) -> Self

Add field context to a BadRequest error

pub fn status_code(&self) -> Option<u16>

Extract the HTTP status code if this is an API error

pub fn is_retryable(&self) -> bool

Check if this error is retryable

pub fn retry_after(&self) -> Option<u64>

Get retry-after duration if available

Trait Implementations

impl Debug for FilesError

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

Formats the value using the given formatter.

impl Display for FilesError

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

Formats the value using the given formatter.

impl Error for FilesError

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.

impl From<Error> for FilesError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FilesError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for FilesError

fn from(source: ParseError) -> Self

Converts to this type from the input type.