Struct HttpResult 

pub struct HttpResult {
    pub success: bool,
    pub status: Option<u16>,
    pub body: Option<Value>,
    pub error: Option<String>,
    pub interrupted: bool,
    pub retryable: bool,
    pub request_id: Option<String>,
    pub retry_after: Option<String>,
    pub retry_after_ms: Option<String>,
}

Result of an HTTP request attempt.

Fields

success: bool

Whether the request completed successfully.

status: Option<u16>

HTTP status code, if a response was received.

body: Option<Value>

Response body, if available.

error: Option<String>

Error message, if the request failed.

interrupted: bool

Whether the request was interrupted by the user.

retryable: bool

Whether the failure is transient and worth retrying.

request_id: Option<String>

Unique request identifier for end-to-end tracing. Propagated via the X-Request-ID header.

retry_after: Option<String>

Value of the Retry-After response header, if present. Used to honor server-requested retry delays on 429/503 responses.

retry_after_ms: Option<String>

Value of the retry-after-ms response header, if present. More precise than Retry-After (milliseconds instead of seconds).

Implementations

impl HttpResult

pub fn ok(status: u16, body: Value) -> Self

Create a successful result.

pub fn fail(error: impl Into<String>, retryable: bool) -> Self

Create a failed result.

pub fn interrupted() -> Self

Create an interrupted result.

pub fn retryable_status( status: u16, body: Option<Value>, retry_after: Option<String>, ) -> Self

Create a result from an HTTP response with a retryable status.

pub fn with_request_id(self, request_id: impl Into<String>) -> Self

Attach a request ID to this result for tracing.

Trait Implementations

impl Debug for HttpResult

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

Formats the value using the given formatter.