Enum XApiError 

pub enum XApiError {
    RateLimited {
        retry_after: Option<u64>,
    },
    AuthExpired,
    AccountRestricted {
        message: String,
    },
    Forbidden {
        message: String,
    },
    ScopeInsufficient {
        message: String,
    },
    Network {
        source: Error,
    },
    ApiError {
        status: u16,
        message: String,
    },
    MediaUploadError {
        message: String,
    },
    MediaProcessingTimeout {
        seconds: u64,
    },
    ScraperMutationBlocked {
        message: String,
    },
    ScraperTransportUnavailable {
        message: String,
    },
    FeatureRequiresAuth {
        message: String,
    },
}

Errors from interacting with the X (Twitter) API.

Variants

RateLimited

X API returned HTTP 429 (rate limited).

Fields

retry_after: Option<u64>

Seconds to wait before retrying, if provided by the API.

AuthExpired

OAuth token is expired and refresh failed.

AccountRestricted

Account is suspended or limited.

Fields

message: String

Details about the restriction.

Forbidden

X API returned HTTP 403 (forbidden / tier restriction).

Fields

message: String

Details about why access is forbidden.

ScopeInsufficient

OAuth scope insufficient for the requested operation.

Fields

message: String

Details about missing or insufficient scopes.

Network

Network-level failure communicating with X API.

Fields

source: Error

The underlying HTTP client error.

ApiError

Any other X API error response.

Fields

status: u16

The HTTP status code.

message: String

The error message from the API.

MediaUploadError

Media upload failed.

Fields

message: String

Details about the upload failure.

MediaProcessingTimeout

Media processing timed out after waiting for the specified duration.

Fields

seconds: u64

Number of seconds waited before timing out.

ScraperMutationBlocked

Mutation blocked because scraper backend has mutations disabled.

Fields

message: String

The operation that was blocked.

ScraperTransportUnavailable

Scraper transport is unavailable or not yet implemented.

Fields

message: String

Details about the transport issue.

FeatureRequiresAuth

Feature requires authenticated X API access (not available in scraper mode).

Fields

message: String

The feature or method that requires authentication.

Trait Implementations

impl Debug for XApiError

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

Formats the value using the given formatter.

impl Display for XApiError

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

Formats the value using the given formatter.

impl Error for XApiError

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<XApiError> for ToolkitError

fn from(source: XApiError) -> Self

Converts to this type from the input type.