Enum VerifyError 

#[non_exhaustive]
pub enum VerifyError {
    AuthFailed {
        detail: String,
    },
    NotFound {
        requested_url: String,
        suggested_url: Option<String>,
    },
    Unreachable {
        proxy_hint: bool,
    },
    ModelNotFound {
        available: Vec<String>,
    },
    ProtocolMismatch {
        expect: Protocol,
    },
    MissingExtraField {
        key: String,
    },
    Malformed {
        detail: String,
    },
}

验证 / 调用失败的结构化原因。

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.

AuthFailed

401 / 403 —— 密钥无效或已过期。

Fields

detail: String

端点返回的原始说明（已脱敏，不含密钥）

NotFound

404 —— 端点不存在。多半是 base_url 缺版本段。

suggested_url 非空时，调用方应提供「一键改用」按钮。

Fields

requested_url: String

实际请求的完整 URL —— 直接展示给用户，省去他猜“到底打了哪个地址“

suggested_url: Option<String>

推断出的正确地址；非空时调用方应给「一键改用」按钮

Unreachable

连不上（超时 / DNS / TLS）。proxy_hint 为真时建议提示用户配代理。

Fields

proxy_hint: bool

该 host 在国内通常需要代理，调用方可据此提示去网络设置

ModelNotFound

端点可达，但它不认当前填的模型名。available 是端点返回的真实清单。

Fields

available: Vec<String>

端点返回的真实可用清单，调用方展开成下拉让用户改选

ProtocolMismatch

密钥只接受另一种协议（典型：中转站的 key 限定 /v1/messages）。

Fields

expect: Protocol

密钥实际要求的协议，调用方据此提示切到对应模板

MissingExtraField

服务商要求的专有字段没填（如豆包 TTS 的 appid）。

调用方应在发起验证之前就用它禁用按钮 —— 禁用态优于「点了才报错」。

Fields

key: String

缺失字段的 key（对应预置里的 extra_fields）

Malformed

端点返回了预期之外的内容（解析失败等）。兜底变体。

Fields

detail: String

解析失败的简述（不含响应体原文，避免把密钥带进日志）

Implementations

impl VerifyError

pub fn is_actionable(&self) -> bool

这个错误是否可能通过「改配置」解决（而非重试）。

调用方据此决定给「重试」还是给「去修改」按钮。

Trait Implementations

impl Clone for VerifyError

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 VerifyError

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

Formats the value using the given formatter.

impl Display for VerifyError

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

Formats the value using the given formatter.

impl Eq for VerifyError

impl Error for VerifyError

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 PartialEq for VerifyError

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for VerifyError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for VerifyError