Struct EzError 

pub struct EzError {
    pub request_id: Option<String>,
    pub task_id: Option<String>,
    pub error_code: Option<String>,
    pub error_description: Option<String>,
    pub errors: BTreeMap<String, String>,
    pub http_status: u16,
}

Structured error returned by the EzCaptchaSolver API.

Fields

request_id: Option<String>

Optional server request identifier.

task_id: Option<String>

Optional task identifier for errors returned after task creation.

error_code: Option<String>

Stable machine-readable error code.

error_description: Option<String>

Human-readable error description.

errors: BTreeMap<String, String>

Field-level validation errors.

http_status: u16

HTTP status code that carried the API error.

Implementations

impl EzError

pub fn is_authentication_error(&self) -> bool

Returns true when this is a credential or balance problem.

A caller that retries one of these is not merely wasting a call: the service counts them per key, and thirty within a minute earn a three-minute ban. Stop rather than back off.

pub fn is_terminal(&self) -> bool

Returns true when resending the identical request would fail identically.

An unrecognised code returns false, because a code this release has not seen may well be transient and the SDK should not talk a caller out of a retry that would have worked. false is not a promise that retrying is safe — the retry policy stays with the caller.

pub fn is_rate_limited(&self) -> bool

Returns true when the service refused the request for throttling rather than for anything about the request itself.

Both codes are transient by construction: a rate limit resets with its window and a ban expires on its own. The asynchronous polling loop treats one as a skipped attempt instead of a failed task, and a caller polling by hand with get_task_result should do the same.

This is narrower than the complement of Self::is_terminal, which is false for every unrecognised code as well — including the worker codes that report a genuinely failed task.

Trait Implementations

impl Clone for EzError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EzError

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

Formats the value using the given formatter.

impl Display for EzError

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

Formats the value using the given formatter.

impl Eq for EzError

impl Error for EzError

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<EzError> for Error

fn from(error: EzError) -> Self

Converts to this type from the input type.

impl PartialEq for EzError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for EzError