Struct BytesRequestBuilder 

pub struct BytesRequestBuilder { /* private fields */ }

表示二进制响应请求构建器。

Implementations

impl BytesRequestBuilder

pub fn body_value(self, body: impl Into<JsonPayload>) -> Self

设置 JSON 请求体。

pub fn json_body<U>(self, body: &U) -> Result<Self>

where U: Serialize,

设置可序列化请求体。

Errors

当序列化失败时返回错误。

pub fn extra_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

追加请求头。

pub fn extra_query( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

追加查询参数。

pub fn provider_option( self, key: impl Into<String>, value: impl Into<JsonPayload>, ) -> Self

在 provider 对应的 provider_options 下追加字段。

pub fn timeout(self, timeout: Duration) -> Self

覆盖请求超时时间。

pub fn max_retries(self, max_retries: u32) -> Self

覆盖最大重试次数。

pub fn cancellation_token(self, token: CancellationToken) -> Self

设置取消令牌。

pub fn multipart_text( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

添加 Multipart 文本字段。

pub fn multipart_file(self, name: impl Into<String>, file: UploadSource) -> Self

添加 Multipart 文件字段。

pub fn extra_body( self, key: impl Into<String>, value: impl Into<JsonPayload>, ) -> Self

在 JSON 根对象中追加字段。

pub async fn send(self) -> Result<Bytes>

发送请求并返回原始字节。

Errors

当请求失败时返回错误。

pub async fn send_with_meta(self) -> Result<ApiResponse<Bytes>>

发送请求并保留响应元信息。

Errors

当请求失败时返回错误。

pub async fn send_raw(self) -> Result<Response<Bytes>>

发送请求并返回原始 HTTP 响应。

Errors

当请求失败时返回错误。

pub async fn send_raw_sse(self) -> Result<RawSseStream>

发送请求并返回原始 SSE 事件流。

该方法会自动追加 Accept: text/event-stream 请求头。

Errors

当请求失败时返回错误。

pub async fn send_sse<T>(self) -> Result<SseStream<T>>

where T: DeserializeOwned + Send + 'static,

发送请求并把 SSE 数据流解析为指定类型。

该方法会自动追加 Accept: text/event-stream 请求头。

Errors

当请求失败或 SSE 事件反序列化失败时返回错误。

Trait Implementations

impl Clone for BytesRequestBuilder

fn clone(&self) -> BytesRequestBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BytesRequestBuilder

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

Formats the value using the given formatter.