Enum WebmasterApiError 

pub enum WebmasterApiError {
    HttpError(Error),
    MiddlewareHttpError(Error),
    ParseError(Error),
    ApiError {
        status: Option<u16>,
        error_code: Option<BingErrorCode>,
        error_code_raw: i32,
        message: String,
    },
    HttpStatusError {
        status: u16,
        message: String,
        response_body: Option<String>,
    },
    InvalidResponse(String),
    AuthenticationError,
    Other(Error),
}

Errors that can occur when interacting with the Bing Webmaster API

Variants

HttpError(Error)

HTTP request failed

MiddlewareHttpError(Error)

Middleware request failed

ParseError(Error)

Failed to parse response

ApiError

API returned a structured error

Fields

status: Option<u16>

HTTP status code (if available)

error_code: Option<BingErrorCode>

Error code enum (if recognized)

error_code_raw: i32

Raw error code value

message: String

Error message from the API

HttpStatusError

HTTP status error without structured API response

Fields

status: u16

HTTP status code

message: String

Error message

response_body: Option<String>

Optional response body

InvalidResponse(String)

Invalid API response format

AuthenticationError

Authentication failed

Other(Error)

Other errors (for anyhow integration)

Implementations

impl WebmasterApiError

pub fn api_error( error_code_raw: i32, message: String, status: Option<u16>, ) -> Self

Create an API error from error code and message

pub fn http_status(status: u16, message: impl Into<String>) -> Self

Create an HTTP status error

pub fn http_status_with_body( status: u16, message: impl Into<String>, response_body: impl Into<String>, ) -> Self

Create an HTTP status error with response body

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

Create an invalid response error

pub fn is_retryable(&self) -> bool

Check if this error is retryable

pub fn is_authentication_error(&self) -> bool

Check if this error is related to authentication

pub fn is_rate_limit_error(&self) -> bool

Check if this error is related to rate limiting

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

Get the HTTP status code if available

pub fn response_body(&self) -> Option<&str>

Get the response body if available

pub fn error_code(&self) -> Option<Result<BingErrorCode, i32>>

Get the error code if this is an API error

Returns the BingErrorCode if recognized, otherwise returns the raw error code value

pub fn api_message(&self) -> Option<&str>

Get the error message if this is an API error

Trait Implementations

impl Debug for WebmasterApiError

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

Formats the value using the given formatter.

impl Display for WebmasterApiError

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

Formats the value using the given formatter.

impl Error for WebmasterApiError

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 WebmasterApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WebmasterApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WebmasterApiError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WebmasterApiError

fn from(source: Error) -> Self

Converts to this type from the input type.