Enum Error 

#[non_exhaustive]
pub enum Error {
    Api {
        code: i64,
        message: String,
        request_id: Option<String>,
        body_snippet: Option<String>,
    },
    Auth(HttpError),
    NotFound(HttpError),
    Conflict(HttpError),
    RateLimited {
        error: HttpError,
        retry_after: Option<Duration>,
    },
    Transport(Box<TransportError>),
    Serialization(Error),
    Timestamp(SystemTimeError),
    Signature,
    InvalidConfig {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

SDK error type and helpers. Unified SDK error type.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Api

API business error returned by DingTalk.

Fields

code: i64

DingTalk error code.

message: String

DingTalk error message.

request_id: Option<String>

Optional request identifier.

body_snippet: Option<String>

Optional redacted response body snippet.

Auth(HttpError)

Authentication/authorization HTTP error.

NotFound(HttpError)

Not-found HTTP error.

Conflict(HttpError)

Conflict HTTP error.

RateLimited

Rate limit error with optional retry hint.

Fields

error: HttpError

Underlying HTTP error.

retry_after: Option<Duration>

Retry-after hint parsed from response headers if available.

Transport(Box<TransportError>)

Transport error from HTTP runtime/client.

Serialization(Error)

JSON serialization/deserialization error.

Timestamp(SystemTimeError)

System timestamp retrieval error.

Signature

Signature generation error.

InvalidConfig

Invalid runtime configuration.

Fields

message: String

Human-readable reason.

source: Option<Box<dyn Error + Send + Sync>>

Optional source error.

Implementations

impl Error

pub fn kind(&self) -> ErrorKind

Returns a stable high-level error category.

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

Returns HTTP status code when present.

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

Returns DingTalk/transport request-id when present.

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

Returns redacted body snippet when retained by the SDK.

pub fn is_auth_error(&self) -> bool

Returns true if the error is an auth/authz failure.

pub fn is_retryable(&self) -> bool

Returns true if the error is likely transient and safe to retry.

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

Returns retry-after hint when the upstream provided one.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SystemTimeError> for Error

fn from(source: SystemTimeError) -> Self

Converts to this type from the input type.