Enum ZaiError 

pub enum ZaiError {
    HttpError {
        status: u16,
        message: String,
    },
    AuthError {
        code: u16,
        message: String,
    },
    AccountError {
        code: u16,
        message: String,
    },
    ApiError {
        code: u16,
        message: String,
    },
    RateLimitError {
        code: u16,
        message: String,
    },
    ContentPolicyError {
        code: u16,
        message: String,
    },
    FileError {
        code: u16,
        message: String,
    },
    NetworkError(Arc<Error>),
    JsonError(Arc<Error>),
    RealtimeError(Arc<RealtimeErrorKind>),
    RealtimeAuthError(String),
    Unknown {
        code: u16,
        message: String,
    },
}

Main error type for the ZAI-RS SDK

Variants

HttpError

HTTP status errors

Fields

status: u16

message: String

AuthError

Authentication and authorization errors

Fields

code: u16

message: String

AccountError

Account-related errors

Fields

code: u16

message: String

ApiError

API call errors

Fields

code: u16

message: String

RateLimitError

Rate limiting and quota errors

Fields

code: u16

message: String

ContentPolicyError

Content policy errors

Fields

code: u16

message: String

FileError

File processing errors

Fields

code: u16

message: String

NetworkError(Arc<Error>)

Network/IO errors (wrapped in Arc for Clone support)

JsonError(Arc<Error>)

JSON parsing errors (wrapped in Arc for Clone support)

RealtimeError(Arc<RealtimeErrorKind>)

Realtime (WebSocket) transport errors — wrapped in Arc so the variant stays Clone-able. See RealtimeErrorKind for the breakdown.

RealtimeAuthError(String)

Realtime authentication / JWT errors (bad API-key shape, signing failure, token rejected during the WebSocket handshake).

Unknown

Other errors

Fields

code: u16

message: String

Implementations

impl ZaiError

pub fn from_api_response( status: u16, api_code: u16, api_message: String, ) -> Self

Convert an HTTP status code and API error response to a ZaiError

pub fn is_rate_limit(&self) -> bool

Check if the error is a rate limit error

pub fn is_auth_error(&self) -> bool

Check if the error is an authentication error

pub fn is_client_error(&self) -> bool

Check if the error is a client error (4xx)

pub fn is_server_error(&self) -> bool

Check if the error is a server error (5xx)

pub fn is_sdk_error(&self) -> bool

Whether this error originates from the SDK itself rather than the API.

True iff code is in the reserved 9000–9999 band (see codes). Variants without a numeric code (NetworkError, JsonError, RealtimeError) return false.

pub fn compact(&self) -> String

Get a compact representation of error suitable for logging

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

Get error code if available

pub fn message(&self) -> String

Get error message

pub fn context(self, context: &str) -> Self

Attach an operational context to this error without losing its code or category.

Prepends "{context}: " to the human-readable message of every variant that carries one. Variants whose payload is a wrapped source error with no message slot (NetworkError, JsonError, RealtimeError) are returned unchanged — record their context in a tracing span instead.

Example

use zai_rs::client::error::ZaiError;

let err = ZaiError::ApiError {
    code: 1200,
    message: "bad model".to_string(),
};
let ctx = err.context("file parser create");
assert_eq!(ctx.code(), Some(1200));
assert_eq!(ctx.message(), "file parser create: bad model");

Trait Implementations

impl Clone for ZaiError

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 ZaiError

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

Formats the value using the given formatter.

impl Display for ZaiError

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

Formats the value using the given formatter.

impl Error for ZaiError

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 ZaiError

Convert from reqwest::Error to ZaiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ZaiError

Convert from serde_json::Error to ZaiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ZaiError

Convert from std::io::Error to ZaiError.

Maps by std::io::ErrorKind so the category (file vs. timeout vs. generic I/O) survives propagation instead of collapsing to a single opaque Unknown{0}. A NetworkError cannot be built from an io::Error (it wraps reqwest::Error), so TimedOut is reported as an ApiError carrying codes::SDK_TIMEOUT.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ZaiError

Convert from a low-level WebSocket (tungstenite) error into a ZaiError. The original error is preserved as the #[source] of RealtimeErrorKind::WebSocket.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<RealtimeErrorKind> for ZaiError

Convert from a realtime transport error kind into a ZaiError.

fn from(kind: RealtimeErrorKind) -> Self

Converts to this type from the input type.

impl From<ValidationErrors> for ZaiError

Convert from validator::ValidationErrors to ZaiError

fn from(err: ValidationErrors) -> Self

Converts to this type from the input type.