Enum SmsError 

pub enum SmsError {
    Http(Error),
    Serialization(Error),
    Authentication {
        code: String,
        message: String,
        request_id: String,
    },
    InvalidParameter {
        code: String,
        message: String,
        request_id: String,
    },
    RateLimited {
        code: String,
        message: String,
        retry_after: Option<Duration>,
        request_id: String,
    },
    InsufficientBalance {
        code: String,
        message: String,
        request_id: String,
    },
    Business {
        code: String,
        message: String,
        request_id: String,
    },
    Internal {
        code: String,
        message: String,
        request_id: String,
    },
    PartialFailure {
        succeeded: Vec<SendStatus>,
        failed: Vec<SendStatus>,
    },
    Configuration(String),
    UnexpectedResponse(String),
}

Variants

Http(Error)

Serialization(Error)

Authentication

Fields

code: String

message: String

request_id: String

InvalidParameter

Fields

code: String

message: String

request_id: String

RateLimited

Fields

code: String

message: String

retry_after: Option<Duration>

request_id: String

InsufficientBalance

Fields

code: String

message: String

request_id: String

Business

Fields

code: String

message: String

request_id: String

Internal

Fields

code: String

message: String

request_id: String

PartialFailure

Fields

succeeded: Vec<SendStatus>

failed: Vec<SendStatus>

Configuration(String)

UnexpectedResponse(String)

Implementations

impl SmsError

pub fn is_retryable(&self) -> bool

判断错误是否可重试

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

获取建议的重试延迟时间

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

获取请求ID(如果存在)

pub fn is_partial_failure(&self) -> bool

判断是否为部分失败错误

示例

match client.send_sms(request).await {
    Ok(results) => { /* 全部成功 */ }
    Err(e) if e.is_partial_failure() => {
        // 部分失败,可以获取成功和失败的数据
        let (succeeded, failed) = e.partial_results().unwrap();
        println!("成功: {}, 失败: {}", succeeded.len(), failed.len());
    }
    Err(e) => { /* 其他错误 */ }
}

pub fn partial_results(&self) -> Option<(&[SendStatus], &[SendStatus])>

获取部分失败的详细数据

返回 (成功列表, 失败列表) 的引用,仅当错误为 PartialFailure 时返回 Some

示例

if let Some((succeeded, failed)) = error.partial_results() {
    for status in succeeded {
        println!("✓ {} 发送成功", status.phone_number);
    }
    for status in failed {
        println!("✗ {} 发送失败: {}", status.phone_number, status.message);
    }
}

pub fn into_partial_results(self) -> Option<(Vec<SendStatus>, Vec<SendStatus>)>

消费错误并获取部分失败的详细数据(拥有所有权)

返回 (成功列表, 失败列表),仅当错误为 PartialFailure 时返回 Some

示例

match client.send_sms(request).await {
    Err(e) => {
        if let Some((succeeded, failed)) = e.into_partial_results() {
            // 现在拥有了 Vec<SendStatus> 的所有权
            process_results(succeeded, failed);
        }
    }
    Ok(results) => { /* ... */ }
}

Trait Implementations

impl Debug for SmsError

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

Formats the value using the given formatter.

impl Display for SmsError

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

Formats the value using the given formatter.

impl Error for SmsError

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 SmsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SmsError

fn from(source: Error) -> Self

Converts to this type from the input type.